@arslankhan/doc-forge 0.0.0-stage → 0.1.1

package/dist/types.d.ts

@@ -0,0 +1,335 @@
+export declare const PAGE_ORIENTATIONS: readonly ["portrait", "landscape"];
+export type PageOrientation = (typeof PAGE_ORIENTATIONS)[number];
+export declare const LAYOUT_MODES: readonly ["fixed", "flow"];
+/** `fixed` uses coordinates. `flow` keeps document order for a later renderer. */
+export type LayoutMode = (typeof LAYOUT_MODES)[number];
+export declare const LENGTH_UNITS: readonly ["mm", "pt", "in", "px"];
+export type LengthUnit = (typeof LENGTH_UNITS)[number];
+export declare const PAPER_SIZES: readonly ["A4", "Letter", "Legal", "custom"];
+export type PaperSize = (typeof PAPER_SIZES)[number];
+export type PaperSizeName = Exclude<PaperSize, "custom">;
+export interface PageDimensions {
+    width: number;
+    height: number;
+    unit: LengthUnit;
+}
+export interface PageMargins {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export interface PageConfiguration {
+    paperSize: PaperSize;
+    orientation: PageOrientation;
+    /** Required when `paperSize` is `custom`. Standard sizes may omit this. */
+    dimensions?: PageDimensions;
+    margins: PageMargins;
+    layoutMode: LayoutMode;
+}
+/** Portrait page sizes in millimeters. Landscape swaps width and height. */
+export declare const PAPER_SIZES_MM: Record<PaperSizeName, {
+    readonly width: number;
+    readonly height: number;
+}>;
+export declare function standardPageDimensions(paperSize: PaperSizeName, orientation: PageOrientation): PageDimensions;
+export interface ElementPosition {
+    x: number;
+    y: number;
+}
+export interface ElementDimensions {
+    width: number;
+    height: number;
+}
+export declare const TEXT_ALIGNS: readonly ["left", "center", "right", "justify"];
+export type TextAlign = (typeof TEXT_ALIGNS)[number];
+export declare const FONT_STYLES: readonly ["normal", "italic"];
+export type FontStyle = (typeof FONT_STYLES)[number];
+export declare const FONT_WEIGHT_NAMES: readonly ["normal", "medium", "bold", "lighter", "bolder"];
+export type FontWeightName = (typeof FONT_WEIGHT_NAMES)[number];
+export type FontWeight = FontWeightName | number;
+export declare const VERTICAL_ALIGNS: readonly ["top", "middle", "bottom"];
+export type VerticalAlign = (typeof VERTICAL_ALIGNS)[number];
+export declare const TEXT_DECORATIONS: readonly ["none", "underline", "line-through"];
+export type TextDecoration = (typeof TEXT_DECORATIONS)[number];
+export declare const BORDER_STYLES: readonly ["solid", "dashed", "dotted", "double", "none"];
+export type BorderStyleName = (typeof BORDER_STYLES)[number];
+/** Padding or an edge length in the page unit. Omitted edges are 0 when any edge is set. */
+export interface BoxEdges {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+/** One side of a border. Omitted fields inherit the element's shared border settings. */
+export interface BorderEdge {
+    width?: number;
+    color?: string;
+    style?: BorderStyleName;
+}
+export interface ElementStyle {
+    color?: string;
+    backgroundColor?: string;
+    fontFamily?: string;
+    fontSize?: number;
+    fontWeight?: FontWeight;
+    fontStyle?: FontStyle;
+    textAlign?: TextAlign;
+    verticalAlign?: VerticalAlign;
+    textDecoration?: TextDecoration;
+    lineHeight?: number;
+    borderColor?: string;
+    borderWidth?: number;
+    borderStyle?: BorderStyleName;
+    borderRadius?: number;
+    borderTop?: BorderEdge;
+    borderRight?: BorderEdge;
+    borderBottom?: BorderEdge;
+    borderLeft?: BorderEdge;
+    padding?: BoxEdges;
+    opacity?: number;
+    strokeColor?: string;
+    strokeWidth?: number;
+}
+/**
+ * Stored data path such as `company.name` or `items.0.name`.
+ * This is not an expression. `resolveBinding` reads the path and does not execute it.
+ * `fallback` is used when the path is missing, null, or not a scalar.
+ * `prefix` and `suffix` are added to that scalar or fallback.
+ */
+export declare const VALUE_FORMAT_STYLES: readonly ["decimal", "currency", "percent", "date"];
+export type ValueFormatStyle = (typeof VALUE_FORMAT_STYLES)[number];
+export declare const DATE_FORMAT_STYLES: readonly ["iso", "short", "medium", "long"];
+export type DateFormatStyle = (typeof DATE_FORMAT_STYLES)[number];
+/**
+ * Display formatting for a bound scalar.
+ * Currency and decimal formats do not change the calculated number.
+ * When `style` is `currency` and `currency` is omitted, the renderer reads `invoice.currency`.
+ * `percent` uses the formatted fraction: `0.15` is shown as 15%.
+ */
+export interface ValueFormat {
+    style: ValueFormatStyle;
+    locale?: string;
+    currency?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    dateStyle?: DateFormatStyle;
+}
+export interface DataBinding {
+    path: string;
+    fallback?: string;
+    prefix?: string;
+    suffix?: string;
+    format?: ValueFormat;
+}
+interface ElementBase {
+    id: string;
+    position: ElementPosition;
+    style?: ElementStyle;
+}
+export interface TextElement extends ElementBase {
+    type: "text";
+    dimensions: ElementDimensions;
+    text?: string;
+    binding?: DataBinding;
+}
+export interface ImageElement extends ElementBase {
+    type: "image";
+    dimensions: ElementDimensions;
+    /**
+     * Static source. This is the image URL when `binding` is absent.
+     * A binding reads `binding.path` instead. `src` stays on the saved template and is not the runtime value.
+     */
+    src?: string;
+    alt?: string;
+    /**
+     * Optional source binding. `path` and `fallback` are used.
+     * `prefix` and `suffix` are stored for compatibility and are not added to an image URL.
+     */
+    binding?: DataBinding;
+}
+export interface LineElement extends ElementBase {
+    type: "line";
+    /**
+     * Span from `position` to `position + dimensions`.
+     * One side may be 0 for a horizontal or vertical line.
+     */
+    dimensions: ElementDimensions;
+}
+export interface RectangleElement extends ElementBase {
+    type: "rectangle";
+    dimensions: ElementDimensions;
+}
+/** One column of a repeating items table. `binding.path` is relative to the current item. */
+export interface ItemsColumn {
+    id: string;
+    header: string;
+    binding: DataBinding;
+    /** Relative width. Columns without a width share the remaining space equally. */
+    width?: number;
+    align?: TextAlign;
+    /** Defaults to visible. */
+    visible?: boolean;
+}
+export interface ItemsElement extends ElementBase {
+    type: "items";
+    dimensions: ElementDimensions;
+    /** Root path of the item array, usually `invoice.items`. */
+    itemsPath: string;
+    columns: ItemsColumn[];
+    /** Defaults to true. */
+    showHeader?: boolean;
+    /** Shown when the array is missing or empty. Defaults to "No items". */
+    emptyText?: string;
+    headerStyle?: ElementStyle;
+    /** Cell padding in the page unit. */
+    padding?: number;
+}
+export interface TotalsRow {
+    id: string;
+    label: string;
+    /** Root path such as `invoice.grandTotal`. */
+    binding: DataBinding;
+    visible?: boolean;
+    /** When true, a numeric zero is omitted. */
+    hideWhenZero?: boolean;
+}
+export interface TotalsElement extends ElementBase {
+    type: "totals";
+    dimensions: ElementDimensions;
+    rows: TotalsRow[];
+}
+export declare const AGGREGATES: readonly ["sum", "count", "min", "max"];
+export type Aggregate = (typeof AGGREGATES)[number];
+export declare const SORT_DIRECTIONS: readonly ["asc", "desc"];
+export type SortDirection = (typeof SORT_DIRECTIONS)[number];
+/** One column of a report table. `binding.path` is relative to the current record. */
+export interface ReportColumn {
+    id: string;
+    header: string;
+    binding: DataBinding;
+    /** Relative width. Columns without a width share the remaining space equally. */
+    width?: number;
+    /** Data alignment. A column `style.textAlign` replaces this for body cells. */
+    align?: TextAlign;
+    /** Defaults to visible. */
+    visible?: boolean;
+    /** When set, group subtotals and the grand total include this column. */
+    aggregate?: Aggregate;
+    /** Header-cell overrides. Only properties set here replace the table header style. */
+    headerStyle?: ElementStyle;
+    /** Body-cell overrides. Only properties set here replace the table body style. */
+    style?: ElementStyle;
+}
+export declare const ROW_RULE_OPERATORS: readonly ["eq", "neq", "gt", "gte", "lt", "lte", "blank"];
+export type RowRuleOperator = (typeof ROW_RULE_OPERATORS)[number];
+/**
+ * Compares one record field with a literal.
+ * `blank` matches a missing path, null, or an empty string. `value` is ignored for `blank`.
+ */
+export interface RowStyleRule {
+    path: string;
+    operator: RowRuleOperator;
+    value?: string | number | boolean;
+    style: ElementStyle;
+}
+export interface ReportGroupLevel {
+    /** Record field path, such as `technician`. */
+    path: string;
+    /** Optional text before the group value. */
+    label?: string;
+}
+export interface ReportSort {
+    path: string;
+    direction: SortDirection;
+}
+export interface ReportTableElement extends ElementBase {
+    type: "reportTable";
+    dimensions: ElementDimensions;
+    /** Root path of the record array, such as `data.jobs`. */
+    collectionPath: string;
+    columns: ReportColumn[];
+    /** Defaults to true. */
+    showHeader?: boolean;
+    /** Shown when the collection is missing or empty. */
+    emptyText?: string;
+    headerStyle?: ElementStyle;
+    /** Cell padding in the page unit. */
+    padding?: number;
+    /** Optional even-row background. Used when `evenRowColor` is omitted. */
+    alternateRowColor?: string;
+    /** Odd record rows, counting from 1. Ignored when `stripeRows` is false. */
+    oddRowColor?: string;
+    /** Even record rows. Falls back to `alternateRowColor`. */
+    evenRowColor?: string;
+    /** Set false to turn zebra striping off without deleting the colors. Defaults to on when a stripe color is set. */
+    stripeRows?: boolean;
+    /** Body cells. Overrides the table style only for properties set here. */
+    bodyStyle?: ElementStyle;
+    groupStyle?: ElementStyle;
+    subtotalStyle?: ElementStyle;
+    grandTotalStyle?: ElementStyle;
+    /** Places the table using its width. Omitted tables stay full width. */
+    tableAlign?: "left" | "center" | "right";
+    /** Header row minimum height in the page unit. */
+    headerHeight?: number;
+    /**
+   * Safe row colors. The first matching rule supplies the cell style.
+   * Paths are read from the record. They are not expressions.
+     */
+    rowRules?: RowStyleRule[];
+    /** Up to three levels. The first level is the outermost group. */
+    groupBy?: ReportGroupLevel[];
+    /** Applied before grouping. The original record order breaks ties. */
+    sort?: ReportSort[];
+    /** Defaults to false. Requires at least one column aggregate. */
+    showGrandTotal?: boolean;
+    grandTotalLabel?: string;
+    /** Starts this table on a new printed page when the browser supports `break-before`. */
+    pageBreakBefore?: boolean;
+}
+export declare const REPORT_BAND_TYPES: readonly ["text", "image"];
+export type ReportBandType = (typeof REPORT_BAND_TYPES)[number];
+export interface ReportTextBand {
+    id: string;
+    type: "text";
+    text?: string;
+    binding?: DataBinding;
+}
+export interface ReportImageBand {
+    id: string;
+    type: "image";
+    src?: string;
+    alt?: string;
+    binding?: DataBinding;
+}
+export type ReportBandEntry = ReportTextBand | ReportImageBand;
+/**
+ * Optional report layout. Ignored by generic documents and invoices.
+ * Page size, orientation, and margins stay on `page`.
+ */
+export interface ReportOptions {
+    /** Static title printed once at the start of the report. */
+    title?: string;
+    description?: string;
+    /** Used when a report table does not set its own empty text. */
+    emptyText?: string;
+    /**
+     * Prints a CSS page counter in the page footer.
+     * The screen preview does not know the page number. Total page count is not rendered.
+     */
+    showPageNumber?: boolean;
+    /** Repeats with each report table header when the table breaks across printed pages. */
+    pageHeader?: ReportBandEntry[];
+    /** Best-effort repeating footer. See the report pagination notes. */
+    pageFooter?: ReportBandEntry[];
+    /** Printed once before the report body. */
+    reportHeader?: ReportBandEntry[];
+    /** Printed once after the report body. */
+    reportFooter?: ReportBandEntry[];
+}
+export type DocumentElement = TextElement | ImageElement | LineElement | RectangleElement | ItemsElement | TotalsElement | ReportTableElement;
+export declare const ELEMENT_TYPES: readonly ["text", "image", "line", "rectangle", "items", "totals", "reportTable"];
+export type ElementType = (typeof ELEMENT_TYPES)[number];
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,40 @@
+export const PAGE_ORIENTATIONS = ["portrait", "landscape"];
+export const LAYOUT_MODES = ["fixed", "flow"];
+export const LENGTH_UNITS = ["mm", "pt", "in", "px"];
+export const PAPER_SIZES = ["A4", "Letter", "Legal", "custom"];
+/** Portrait page sizes in millimeters. Landscape swaps width and height. */
+export const PAPER_SIZES_MM = {
+    A4: { width: 210, height: 297 },
+    Letter: { width: 215.9, height: 279.4 },
+    Legal: { width: 215.9, height: 355.6 },
+};
+export function standardPageDimensions(paperSize, orientation) {
+    const size = PAPER_SIZES_MM[paperSize];
+    if (orientation === "landscape") {
+        return { width: size.height, height: size.width, unit: "mm" };
+    }
+    return { width: size.width, height: size.height, unit: "mm" };
+}
+export const TEXT_ALIGNS = ["left", "center", "right", "justify"];
+export const FONT_STYLES = ["normal", "italic"];
+export const FONT_WEIGHT_NAMES = ["normal", "medium", "bold", "lighter", "bolder"];
+export const VERTICAL_ALIGNS = ["top", "middle", "bottom"];
+export const TEXT_DECORATIONS = ["none", "underline", "line-through"];
+export const BORDER_STYLES = ["solid", "dashed", "dotted", "double", "none"];
+/**
+ * Stored data path such as `company.name` or `items.0.name`.
+ * This is not an expression. `resolveBinding` reads the path and does not execute it.
+ * `fallback` is used when the path is missing, null, or not a scalar.
+ * `prefix` and `suffix` are added to that scalar or fallback.
+ */
+export const VALUE_FORMAT_STYLES = ["decimal", "currency", "percent", "date"];
+export const DATE_FORMAT_STYLES = ["iso", "short", "medium", "long"];
+export const AGGREGATES = ["sum", "count", "min", "max"];
+export const SORT_DIRECTIONS = ["asc", "desc"];
+export const ROW_RULE_OPERATORS = ["eq", "neq", "gt", "gte", "lt", "lte", "blank"];
+export const REPORT_BAND_TYPES = ["text", "image"];
+export const ELEMENT_TYPES = ["text", "image", "line", "rectangle", "items", "totals", "reportTable"];
+/** Keeps the element registry aligned with the element union. */
+const elementTypesCovered = true;
+void elementTypesCovered;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/validate.d.ts

@@ -0,0 +1,15 @@
+export interface TemplateValidationIssue {
+    path: string;
+    code: string;
+    message: string;
+}
+export interface TemplateValidationResult {
+    valid: boolean;
+    errors: TemplateValidationIssue[];
+}
+export declare class TemplateValidationError extends Error {
+    readonly errors: readonly TemplateValidationIssue[];
+    constructor(errors: readonly TemplateValidationIssue[]);
+}
+export declare function validateTemplate(input: unknown): TemplateValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,uBAAuB,EAAE,CAAC;CACnC;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,CAAC;gBAExC,MAAM,EAAE,SAAS,uBAAuB,EAAE;CAMvD;AAoJD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAqBzE"}