quds_reports library

Classes

ArabicCurrency: Currency definition for ArabicTafqeet and currency: formats.
ArabicNounForms: Grammatical forms of a counted Arabic noun (معدود).
ArabicTafqeet: Converts numbers to grammatical Arabic words.
EnglishCurrency: English names of a currency's main unit and subunit.
EnglishWords: English words: EnglishWords.amount(1250.5, 'USD') → One thousand two hundred fifty US dollars and fifty cents only.
QudsExpressionEngine: Evaluates ReportExpressions and interpolates ReportTemplateText.
QudsReportEngine: Band report engine.
QudsReportXmlParser: Reads <QudsReport> XML into a ReportTemplate.
QudsReportXmlWriter: Serializes a ReportTemplate back to .qrep XML.
ReportBand: One band section with its elements.
ReportBarcodeElement: Code 128 or QR symbol.
ReportBarcodePrimitive: Barcode modules painted inside bounds.
ReportBinary: Raw bytes (images bound from data such as {{Data.logo}}).
ReportBinaryExpr: Infix operator.
ReportBool: Boolean value.
ReportCallExpr: NAME(args…)
ReportChartData: Aggregated chart content ready to draw or export.
ReportChartElement: Vector chart fed by a data set (one category per distinct category value, one series per series entry) or by static points.
ReportChartPoint: <Point label="…" value="…" color="…"/> — a static data point.
ReportChartRenderer: Turns ReportChartData into page primitives inside a box.
ReportChartSeries: <Series name="…" value="…" color="…"/> — one plotted measure.
ReportChartSeriesData: One resolved series: a value per category.
ReportColor: Opaque or translucent sRGB color.
ReportCompleter: Computes completions from the template, the band being edited, and the data the preview uses (field names come from real or mock rows).
ReportCompletionItem: One suggestion.
ReportCompletionResult: Suggestions for one caret position.
ReportConditionalExpr: cond ? a : b
ReportCrosstabElement: Pivot of one data set: one row per rowField, one column per columnField.
ReportCsv: Comma-separated values: header row + data rows.
ReportData: JSON-like data a host feeds to a report: nested maps for records, lists of maps for tables.
ReportDataColumn: One column of a ReportDataTable. A column with an expression is calculated for every row (qty * price) when the report is generated.
ReportDataField: A single value outside the tables (Data.customer.name).
ReportDataSchema: What a report expects from its data (<DataSchema>), saved with the template so hosts and designers agree on names and types.
ReportDataTable: A data set (<Table name="items">): the rows a detail band, table, or chart repeats over.
ReportDate: Date / time value.
ReportDiagnostic: One validation finding with a template path (Bands/Detail/Table[0]).
ReportDiagnosticTarget: Where in a template a ReportDiagnostic points, parsed from its ReportDiagnostic.path (Bands/Detail/Text[2]@visibleWhen, Variables/total, DataSchema/items/amount, …).
ReportDocumentLayout: Complete paginated report.
ReportDocxWriter: Flow-based Word export.
ReportElement: Base of every positioned element.
ReportExpr: Expression syntax tree.
ReportExpression: A parsed expression with its source text.
ReportExpressionSegment: {{ expression | format }}
ReportFlowBand: A printed band with its positioned items (y relative to the band top).
ReportFlowCell: Evaluated table cell.
ReportFlowChart: Chart with its aggregated data (XLSX / DOCX write native charts).
ReportFlowEntry: Logical content of a band instance, independent of page geometry.
ReportFlowImage: Image element with resolved bytes.
ReportFlowItem: Positioned item inside a ReportFlowBand.
ReportFlowRule: Horizontal rule (a line shape flatter than it is wide).
ReportFlowSpan: One styled slice inside a ReportFlowText.
ReportFlowTableBlock: Table printed atomically inside a non-detail band.
ReportFlowTableRow: Table header, body row, or totals row.
ReportFlowText: Evaluated text element.
ReportFontFamily: Regular, bold, italic, and bold-italic faces of one family.
ReportFontFile: Reads TrueType headers without parsing glyphs, so a host can scan installed fonts quickly and reports only embed files they can draw.
ReportFontFileInfo: What a TrueType file declares in its name, OS/2, head and cmap tables.
ReportFontFiles: Regular and bold TrueType files of one embedded family. At least one is set; a missing face falls back to the other.
ReportFontRegistry: Families available to the report engine.
ReportFontSpec: Text style resolved for shaping.
ReportFormatDefaults: Locale-ish defaults applied when a format omits details.
ReportFormatter: Formats ReportValues for display.
ReportFunctionInfo: Built-in function documentation.
ReportGenerator: Lays out a ReportTemplate against data.
ReportGroupInfo: Current group while evaluating group bands and rows.
ReportIdentifierExpr: Bare name (item, System, total).
ReportImageElement: Picture from embedded bytes, a named resource, or a data binding.
ReportImagePrimitive: Raster image placed at imageRect, clipped to bounds.
ReportIndexExpr: target[index]
ReportLinePrimitive: Straight line.
ReportList: Ordered list (data set rows, projections such as items.total).
ReportLiteralExpr: Constant.
ReportLiteralSegment: Literal text between expressions.
ReportMargins: Page margins in points.
ReportMemberExpr: target.name
ReportMockData: Builds plausible data for every binding a template uses, so a designer can preview pagination, grouping, and totals before real data exists.
ReportNull: Absent / null value.
ReportNumber: Integer or floating point number.
ReportPackage: A .qrep report file: xml layout plus pre-saved images and fonts.
ReportPageLayout: One output page.
ReportPageSize: Named page size in points (portrait).
ReportParseResult: Parse output: the template (best effort) plus diagnostics.
ReportPathPrimitive: Polyline or polygon (chart lines, areas, and pie wedges).
ReportPdfWriter: Writes report layouts with the writer-side PdfDocument.
ReportPrimitive: Drawing operation on a page. Coordinates are page points, y down.
ReportRecord: Named fields (one data row, the root data object, System, Variables).
ReportRect: Axis-aligned rectangle in points.
ReportRectPrimitive: Rectangle, rounded rectangle, or ellipse.
ReportScope: Everything an expression can see.
ReportSection: One data region: optional group header, a detail band, optional group footer.
ReportShapedChar: Shaped code point with its advance multiplier (lam-alef ligatures).
ReportShapedText: Wrapped, shaped paragraph.
ReportShapeElement: Line, rectangle, rounded rectangle, or ellipse.
ReportShapeFeature: One named region (a country, a district, a custom polygon).
ReportShapeFile: A shape file read for a report: the layer to embed, and the attribute whose values are the region keys (null for a .qmap, which already stores them).
ReportShapeLayer: A set of regions drawn as one map.
ReportShapeRing: One closed ring. A hole is drawn in the ocean color.
ReportShapes: world and countries are the bundled atlas. Anything else is an embedded shape layer.
ReportSubreportElement: Renders another template stored at subreports/<name>.xml in the package.
ReportSystemInfo: Values exposed as System.*.
ReportTableCell: <Cell field="item.code" format="…"/> or <Cell text="{{…}}"/>.
ReportTableColumn: <Column width="…" header="…" align="…"/>.
ReportTableElement: Repeating grid bound to the detail data set.
ReportTemplate: A complete report template (<QudsReport>).
ReportTemplateArt: Sample pictures embedded in the ready-made templates (ReportTemplates).
ReportTemplateInfo: One catalog entry: XML plus the sample data, images, and fonts it needs.
ReportTemplateManifest: Catalog details of a template .qrep, saved in the package as entry (template.json). A report file that carries one is offered as a starting point (ReportTemplateInfo.fromPackage).
ReportTemplates: Catalog of professional starting points, grouped by ReportTemplateCategory; every family ships Arabic and English versions.
ReportTemplateText: Text with {{ … }} placeholders, parsed once and cached by source.
ReportText: Text value.
ReportTextElement: Static or bound text.
ReportTextLine: Logical slice of the source text placed on one line.
ReportTextPrimitive: Shaped paragraph inside contentRect.
ReportTextRun: One styled slice of a ReportTextElement.
ReportTextSegment: One piece of an interpolated template string.
ReportTextShaper: Shapes and wraps text with the same metrics the PDF writer paints.
ReportTextStyle: Font and color overrides for text. Null fields inherit report defaults.
ReportUnaryExpr: Prefix operator.
ReportUnits: Length parsing and formatting. All engine geometry is in points.
ReportValue: A value bound from report data or produced by an expression.
ReportVariable: Value stored in the template itself (<Variables>), referenced as {{Variables.name}}. Host values passed to the engine override it.
ReportXlsxWriter: Data-oriented Excel export of a laid-out report.
TafqeetOptions: Output options for ArabicTafqeet.amount.
WorldCountries: Bundled admin-0 countries, keyed by ISO code and by English, Arabic, and French names.

Enums

ReportBandKind: Band sections, in canonical document order.
ReportBarcodeType: Barcode symbology.
ReportBinaryOp: Binary operators, lowest precedence last in the parser.
ReportChartAggregate: How rows sharing a category are combined into one chart value.
ReportChartSort: Category order after aggregation.
ReportChartType: Chart family drawn by a ReportChartElement.
ReportCompletionKind: What a completion inserts.
ReportCoordinateOrigin: Origin of element x coordinates.
ReportDataType: Column or field type. Text values fed by a host are converted to it ('12.5' → 12.5, '2026-10-12' → a date).
ReportDiagnosticKind: Broad nature of a ReportDiagnostic, for grouping and explaining it.
ReportDiagnosticPlace: Part of a report a ReportDiagnostic points at.
ReportDiagnosticSeverity: Severity of a ReportDiagnostic.
ReportElementType: Element kind (mirrors type="…").
ReportExportFormat: Output format of QudsReportEngine.export.
ReportImageFit: Image scaling.
ReportImageFormat: Image format accepted inside a .qrep package.
ReportLineStyle: Stroke pattern.
ReportOrientation: Page orientation.
ReportProductArt: Products drawn by ReportTemplateArt.product.
ReportScript: Writing systems a font preview can be shown in, each with sample text and the code points that show a font covers it.
ReportSeriesStyle: How one combo series is drawn.
ReportShapeKind: Shape kind.
ReportTemplateCategory: What a template is for (designer grouping).
ReportTemplateLanguage: Language a template prints in.
ReportTextAlign: Horizontal text alignment. start/end follow the text direction.
ReportTextDirection: Paragraph direction override.
ReportUnaryOp: Unary operators.
ReportUnit: Length unit accepted by template attributes such as x="10mm".
ReportVariableType: <Var name="…" value="…"/>. value may contain {{ }} placeholders. Data type of a template variable.
ReportVerticalAlign: Vertical alignment inside an element box.

Functions

compareReportValues(ReportValue a, ReportValue b) → int: Ordering used by MIN, MAX, comparisons, and group sorting.
reportEnumByName<T extends Enum>(List<T> values, String? name) → T?: Enum value for name ignoring case, -, and _.
reportStyleFont(ReportTextStyle style, ReportFontSpec base) → ReportFontSpec: style over base. Empty fields keep base.
reportValuesEqual(ReportValue a, ReportValue b) → bool: Loose equality used by == in expressions ('5' == 5 is true).

Typedefs

ReportFunction = ReportValue Function(List<ReportValue> arguments): Host-provided function: MYFN(a, b) receives evaluated arguments.

Exceptions / Errors

ReportDataException: Thrown for malformed JSON or CSV data.
ReportElementException: Thrown by the named-element API (QudsReportEngine.element and the setters) when no element has the name or it is of another type.
ReportExpressionException: Thrown for malformed expressions or evaluation failures.
ReportFontException: Thrown when a font cannot be used for embedding.
ReportFormatException: Thrown when a length or color attribute cannot be parsed.
ReportPackageException: Thrown when .qrep bytes are neither a valid package nor plain XML.
ReportShapeException: Thrown when shape bytes are not a shapefile, GeoJSON, or a shape layer.
ReportTemplateException: Thrown when a template has validation errors.
TafqeetException: Thrown for unknown currency codes or out-of-range amounts.

quds_reports library

Classes

Enums

Functions

Typedefs

Exceptions / Errors

quds_office_engine package

quds_reports library