@nowline/export-core 0.2.0

package/dist/generated/bundled-fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-fonts.js","sourceRoot":"","sources":["../../src/generated/bundled-fonts.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,6CAA6C;AAC7C,EAAE;AACF,qEAAqE;AACrE,sEAAsE;AACtE,YAAY;AAEZ,MAAM,CAAC,MAAM,WAAW,GAAG,8xz9BAA8xz9B,CAAC;AAE1zz9B,MAAM,CAAC,MAAM,WAAW,GAAG,8o3bAA8o3b,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { displayLabel, getProp, getProps, hasProp, type PropertyHost, roadmapTitle, } from './ast-helpers.js';
+export { BUNDLED_MONO_PATH, BUNDLED_SANS_PATH, clearBundledCache, loadBundledMono, loadBundledSans, } from './fonts/bundled.js';
+export { ALIASES, aliasCandidate, type FontCandidate, isAlias, type PlatformProbe, probeListFor, } from './fonts/probe-list.js';
+export { FontResolveError, type ResolveOptions, type ResolveResult, resolveFonts, } from './fonts/resolve.js';
+export { isVariableFontBytes } from './fonts/sfns.js';
+export { type ContentScale, fitContent, isPdfPresetName, PageSizeParseError, parsePageSize, presetDimensions, presetNames, type ResolvedPage, resolvePage, validateMargin, } from './pdf-page.js';
+export type { ExportInputs, FontRole, FontSource, PdfLength, PdfLengthUnit, PdfOrientation, PdfPageSize, PdfPresetName, ResolvedFont, ResolvedFontPair, } from './types.js';
+export { LengthParseError, lengthToPoints, parseLength, pointsToLength, } from './units.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,OAAO,EACP,KAAK,YAAY,EACjB,YAAY,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,OAAO,EACP,cAAc,EACd,KAAK,aAAa,EAClB,OAAO,EACP,KAAK,aAAa,EAClB,YAAY,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,YAAY,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EACH,KAAK,YAAY,EACjB,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,KAAK,YAAY,EACjB,WAAW,EACX,cAAc,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EACR,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { displayLabel, getProp, getProps, hasProp, roadmapTitle, } from './ast-helpers.js';
+export { BUNDLED_MONO_PATH, BUNDLED_SANS_PATH, clearBundledCache, loadBundledMono, loadBundledSans, } from './fonts/bundled.js';
+export { ALIASES, aliasCandidate, isAlias, probeListFor, } from './fonts/probe-list.js';
+export { FontResolveError, resolveFonts, } from './fonts/resolve.js';
+export { isVariableFontBytes } from './fonts/sfns.js';
+export { fitContent, isPdfPresetName, PageSizeParseError, parsePageSize, presetDimensions, presetNames, resolvePage, validateMargin, } from './pdf-page.js';
+export { LengthParseError, lengthToPoints, parseLength, pointsToLength, } from './units.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,OAAO,EAEP,YAAY,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACH,OAAO,EACP,cAAc,EAEd,OAAO,EAEP,YAAY,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,gBAAgB,EAGhB,YAAY,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAEH,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,WAAW,EAEX,WAAW,EACX,cAAc,GACjB,MAAM,eAAe,CAAC;AAavB,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,cAAc,GACjB,MAAM,YAAY,CAAC"}

package/dist/pdf-page.d.ts

@@ -0,0 +1,66 @@
+import type { PdfOrientation, PdfPageSize, PdfPresetName } from './types.js';
+interface PresetDimensions {
+    widthPt: number;
+    heightPt: number;
+}
+export declare class PageSizeParseError extends Error {
+    constructor(message: string);
+}
+export declare function isPdfPresetName(value: string): value is PdfPresetName;
+export declare function presetNames(): readonly PdfPresetName[];
+export declare function presetDimensions(name: PdfPresetName): PresetDimensions;
+/**
+ * Parse a `--page-size` value: preset name, custom `WxHunit`, or `content`.
+ * Case-insensitive.
+ */
+export declare function parsePageSize(input: string): PdfPageSize;
+export interface ResolvedPage {
+    widthPt: number;
+    heightPt: number;
+    orientation: 'portrait' | 'landscape';
+    isContentSized: boolean;
+}
+/**
+ * Resolve the final page rectangle (in points) from page size, orientation,
+ * and content dimensions.
+ *
+ * Rules per § 4 "Orientation" / "Scaling":
+ *  - `--page-size content` → page = content + 2 × margin; orientation derived from
+ *    the resulting aspect; `orientation` argument is ignored.
+ *  - Fixed page (preset or custom):
+ *      `auto` → portrait if content taller-than-wide, landscape otherwise.
+ *      `portrait` / `landscape` → swap the preset W/H if the preset is in the
+ *      opposite orientation.
+ */
+export declare function resolvePage(args: {
+    pageSize: PdfPageSize;
+    orientation: PdfOrientation;
+    contentWidthPt: number;
+    contentHeightPt: number;
+    marginPt: number;
+}): ResolvedPage;
+/**
+ * Validate a margin against the resolved page. `margin × 2 ≥ either dim`
+ * means the printable area collapses; throw with a pointer at `--margin`.
+ */
+export declare function validateMargin(marginPt: number, page: ResolvedPage): void;
+export interface ContentScale {
+    /** Factor applied to content; 1 = native, < 1 = shrink to fit. */
+    factor: number;
+    /** Top-left of where the (scaled) content begins inside the page. */
+    offsetX: number;
+    offsetY: number;
+}
+/**
+ * For fixed-page mode, fit (centered, never up-scaled) the content rectangle
+ * inside the printable area `(page − 2 × margin)`. For content-sized pages,
+ * the factor is always 1 and the offset is just the margin.
+ */
+export declare function fitContent(args: {
+    page: ResolvedPage;
+    contentWidthPt: number;
+    contentHeightPt: number;
+    marginPt: number;
+}): ContentScale;
+export {};
+//# sourceMappingURL=pdf-page.d.ts.map

package/dist/pdf-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-page.d.ts","sourceRoot":"","sources":["../src/pdf-page.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAa,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGxF,UAAU,gBAAgB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB;AA+BD,qBAAa,kBAAmB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI9B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAErE;AAED,wBAAgB,WAAW,IAAI,SAAS,aAAa,EAAE,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CAEtE;AAQD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAiCxD;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,GAAG,WAAW,CAAC;IACtC,cAAc,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAC9B,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,cAAc,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,YAAY,CAqCf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CASzE;AAED,MAAM,WAAW,YAAY;IACzB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,YAAY,CAiBf"}

package/dist/pdf-page.js

@@ -0,0 +1,170 @@
+// PDF page-size parsing, preset table, and orientation/margin resolution.
+//
+// Spec: specs/handoffs/m2c.md § 4 "PDF — vector PDF via PDFKit"
+//   - Default: US Letter (8.5 × 11 in) portrait.
+//   - Presets: imperial (letter, legal, tabloid, ledger) + ISO 216 (a5–a1, b5–b3).
+//   - Custom: WxHunit (mixed units rejected).
+//   - "content": page = content dimensions, no scaling, no upper bound.
+import { LengthParseError, lengthToPoints, parseLength } from './units.js';
+function fromMm(widthMm, heightMm) {
+    const factor = 72 / 25.4;
+    return {
+        widthPt: roundToMicropoint(widthMm * factor),
+        heightPt: roundToMicropoint(heightMm * factor),
+    };
+}
+function roundToMicropoint(n) {
+    return Math.round(n * 1000) / 1000;
+}
+const PRESETS = {
+    letter: { widthPt: 612, heightPt: 792 },
+    legal: { widthPt: 612, heightPt: 1008 },
+    tabloid: { widthPt: 792, heightPt: 1224 },
+    ledger: { widthPt: 1224, heightPt: 792 },
+    a1: fromMm(594, 841),
+    a2: fromMm(420, 594),
+    a3: fromMm(297, 420),
+    a4: fromMm(210, 297),
+    a5: fromMm(148, 210),
+    b3: fromMm(353, 500),
+    b4: fromMm(250, 353),
+    b5: fromMm(176, 250),
+};
+const PRESET_NAMES = Object.keys(PRESETS);
+export class PageSizeParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PageSizeParseError';
+    }
+}
+export function isPdfPresetName(value) {
+    return PRESET_NAMES.includes(value.toLowerCase());
+}
+export function presetNames() {
+    return PRESET_NAMES;
+}
+export function presetDimensions(name) {
+    return PRESETS[name];
+}
+// Canonical form: `<W>x<H><unit>` — single trailing unit applies to both
+// (e.g. `8.5x11in`).
+// Explicit form: `<W><unit>x<H><unit>` — both dimensions tagged. Same unit
+// required; mismatch is rejected as "mixed units".
+const CUSTOM_RE = /^(\d+(?:\.\d+)?)([a-z]+)?x(\d+(?:\.\d+)?)([a-z]+)$/i;
+/**
+ * Parse a `--page-size` value: preset name, custom `WxHunit`, or `content`.
+ * Case-insensitive.
+ */
+export function parsePageSize(input) {
+    const lower = input.trim().toLowerCase();
+    if (!lower)
+        throw new PageSizeParseError('empty page size');
+    if (lower === 'content')
+        return { kind: 'content' };
+    if (isPdfPresetName(lower)) {
+        return { kind: 'preset', name: lower };
+    }
+    const match = CUSTOM_RE.exec(lower);
+    if (!match) {
+        throw new PageSizeParseError(`invalid page size "${input}": expected preset (${PRESET_NAMES.join(', ')}), "content", or <W>x<H><unit> (e.g. 8.5x11in)`);
+    }
+    const [, wRaw, wUnitMaybe, hRaw, hUnit] = match;
+    if (wUnitMaybe !== undefined && wUnitMaybe !== hUnit) {
+        throw new PageSizeParseError(`invalid page size "${input}": mixed units (${wUnitMaybe} vs ${hUnit}); use the same unit for width and height`);
+    }
+    let width;
+    let height;
+    try {
+        width = parseLength(`${wRaw}${hUnit}`);
+        height = parseLength(`${hRaw}${hUnit}`);
+    }
+    catch (err) {
+        if (err instanceof LengthParseError) {
+            throw new PageSizeParseError(`invalid page size "${input}": ${err.message}`);
+        }
+        throw err;
+    }
+    return { kind: 'custom', width, height };
+}
+/**
+ * Resolve the final page rectangle (in points) from page size, orientation,
+ * and content dimensions.
+ *
+ * Rules per § 4 "Orientation" / "Scaling":
+ *  - `--page-size content` → page = content + 2 × margin; orientation derived from
+ *    the resulting aspect; `orientation` argument is ignored.
+ *  - Fixed page (preset or custom):
+ *      `auto` → portrait if content taller-than-wide, landscape otherwise.
+ *      `portrait` / `landscape` → swap the preset W/H if the preset is in the
+ *      opposite orientation.
+ */
+export function resolvePage(args) {
+    const { pageSize, orientation, contentWidthPt, contentHeightPt, marginPt } = args;
+    if (pageSize.kind === 'content') {
+        const widthPt = contentWidthPt + 2 * marginPt;
+        const heightPt = contentHeightPt + 2 * marginPt;
+        return {
+            widthPt,
+            heightPt,
+            orientation: widthPt >= heightPt ? 'landscape' : 'portrait',
+            isContentSized: true,
+        };
+    }
+    let widthPt;
+    let heightPt;
+    if (pageSize.kind === 'preset') {
+        ({ widthPt, heightPt } = PRESETS[pageSize.name]);
+    }
+    else {
+        widthPt = lengthToPoints(pageSize.width);
+        heightPt = lengthToPoints(pageSize.height);
+    }
+    const resolvedOrientation = orientation === 'auto'
+        ? contentWidthPt > contentHeightPt
+            ? 'landscape'
+            : 'portrait'
+        : orientation;
+    if (resolvedOrientation === 'landscape' && widthPt < heightPt) {
+        [widthPt, heightPt] = [heightPt, widthPt];
+    }
+    else if (resolvedOrientation === 'portrait' && widthPt > heightPt) {
+        [widthPt, heightPt] = [heightPt, widthPt];
+    }
+    return { widthPt, heightPt, orientation: resolvedOrientation, isContentSized: false };
+}
+/**
+ * Validate a margin against the resolved page. `margin × 2 ≥ either dim`
+ * means the printable area collapses; throw with a pointer at `--margin`.
+ */
+export function validateMargin(marginPt, page) {
+    if (!Number.isFinite(marginPt) || marginPt < 0) {
+        throw new PageSizeParseError('invalid margin: must be a non-negative number of points');
+    }
+    if (marginPt * 2 >= page.widthPt || marginPt * 2 >= page.heightPt) {
+        throw new PageSizeParseError(`margin ${marginPt}pt consumes the entire ${page.widthPt}x${page.heightPt}pt page`);
+    }
+}
+/**
+ * For fixed-page mode, fit (centered, never up-scaled) the content rectangle
+ * inside the printable area `(page − 2 × margin)`. For content-sized pages,
+ * the factor is always 1 and the offset is just the margin.
+ */
+export function fitContent(args) {
+    const { page, contentWidthPt, contentHeightPt, marginPt } = args;
+    if (page.isContentSized) {
+        return { factor: 1, offsetX: marginPt, offsetY: marginPt };
+    }
+    const printableW = page.widthPt - 2 * marginPt;
+    const printableH = page.heightPt - 2 * marginPt;
+    const scaleX = printableW / contentWidthPt;
+    const scaleY = printableH / contentHeightPt;
+    const factor = Math.min(scaleX, scaleY, 1);
+    const scaledW = contentWidthPt * factor;
+    const scaledH = contentHeightPt * factor;
+    return {
+        factor,
+        offsetX: marginPt + (printableW - scaledW) / 2,
+        offsetY: marginPt + (printableH - scaledH) / 2,
+    };
+}
+//# sourceMappingURL=pdf-page.js.map

package/dist/pdf-page.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+import type { NowlineFile, ResolveResult } from '@nowline/core';
+import type { PositionedRoadmap } from '@nowline/layout';
+/** Bundle of inputs every export function consumes. */
+export interface ExportInputs {
+    /** Positioned model produced by `layoutRoadmap()`. */
+    model: PositionedRoadmap;
+    /** Original AST — needed for XLSX / Mermaid / MS Project. */
+    ast: NowlineFile;
+    /** Include-resolved data — needed for XLSX joins. */
+    resolved: ResolveResult;
+    /**
+     * Display path for the source. Use `'<stdin>'` when piped. Used in
+     * footers / metadata; never for filesystem reads.
+     */
+    sourcePath: string;
+    /**
+     * Optional pinned timestamp. Exporters that would otherwise call
+     * `new Date()` (PDF CreationDate, XLSX Created) MUST take this from
+     * `ast.generated` first, then `today`, never `new Date()`.
+     */
+    today?: Date;
+}
+export type PdfPresetName = 'letter' | 'legal' | 'tabloid' | 'ledger' | 'a5' | 'a4' | 'a3' | 'a2' | 'a1' | 'b5' | 'b4' | 'b3';
+export type PdfLengthUnit = 'pt' | 'in' | 'mm' | 'cm';
+export interface PdfLength {
+    value: number;
+    unit: PdfLengthUnit;
+}
+export type PdfPageSize = {
+    kind: 'preset';
+    name: PdfPresetName;
+} | {
+    kind: 'custom';
+    width: PdfLength;
+    height: PdfLength;
+} | {
+    kind: 'content';
+};
+export type PdfOrientation = 'portrait' | 'landscape' | 'auto';
+/** Where the resolver landed when it stopped. */
+export type FontSource = 'flag' | 'env' | 'headless' | 'probe' | 'bundled';
+export type FontRole = 'sans' | 'mono';
+export interface ResolvedFont {
+    /** Friendly family name, e.g. 'DejaVu Sans', 'SF Pro'. */
+    name: string;
+    /** Full TTF/OTF bytes, ready for PDFKit / resvg consumption. */
+    bytes: Uint8Array;
+    /** Where in the resolver chain this font came from. */
+    source: FontSource;
+    /** Filesystem path; undefined for bundled / synthesized bytes. */
+    path?: string;
+    /** Face inside a `.ttc` collection, if applicable. */
+    face?: string;
+    /** True when the loaded font is an OpenType variable font (axes, no fixed instance). */
+    isVariableFont?: boolean;
+}
+export interface ResolvedFontPair {
+    sans: ResolvedFont;
+    mono: ResolvedFont;
+}
+//# 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":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,uDAAuD;AACvD,MAAM,WAAW,YAAY;IACzB,sDAAsD;IACtD,KAAK,EAAE,iBAAiB,CAAC;IACzB,6DAA6D;IAC7D,GAAG,EAAE,WAAW,CAAC;IACjB,qDAAqD;IACrD,QAAQ,EAAE,aAAa,CAAC;IACxB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC;CAChB;AAID,MAAM,MAAM,aAAa,GAEnB,QAAQ,GACR,OAAO,GACP,SAAS,GACT,QAAQ,GAER,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GAEJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtD,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAE1B,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAI/D,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3E,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,MAAM,WAAW,YAAY;IACzB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,EAAE,UAAU,CAAC;IAClB,uDAAuD;IACvD,MAAM,EAAE,UAAU,CAAC;IACnB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,6 @@
+// Shared types consumed by every @nowline/export-* package.
+//
+// Heavy deps (resvg, pdfkit, exceljs) live in the format packages, never
+// here — see specs/handoffs/m2c.md § 1.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,yEAAyE;AACzE,wCAAwC"}

package/dist/units.d.ts

@@ -0,0 +1,16 @@
+import type { PdfLength, PdfLengthUnit } from './types.js';
+/** Convert a tagged length to PDF points. */
+export declare function lengthToPoints(length: PdfLength): number;
+/** Convert a raw point count back to a tagged length in the requested unit. */
+export declare function pointsToLength(points: number, unit: PdfLengthUnit): PdfLength;
+export declare class LengthParseError extends Error {
+    constructor(input: string, reason: string);
+}
+/**
+ * Parse a unit-tagged length like `36pt`, `0.5in`, `10mm`, `1cm`.
+ *
+ * Throws `LengthParseError` on missing unit, unknown unit, non-numeric, zero,
+ * or negative values.
+ */
+export declare function parseLength(input: string): PdfLength;
+//# sourceMappingURL=units.d.ts.map

package/dist/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../src/units.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAS3D,6CAA6C;AAC7C,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAExD;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,SAAS,CAE7E;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC3B,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI5C;AAKD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAkBpD"}

package/dist/units.js

@@ -0,0 +1,56 @@
+// Length conversions and parsing for PDF page sizing.
+//
+// PDF native unit is the "PostScript point": 1 pt = 1/72 in. Every length
+// resolves to points before the page is laid out — see specs/handoffs/m2c.md
+// § 4 "Unit conversion".
+const POINTS_PER_UNIT = {
+    pt: 1,
+    in: 72,
+    mm: 72 / 25.4, // ≈ 2.83464567
+    cm: 72 / 2.54, // ≈ 28.3464567
+};
+/** Convert a tagged length to PDF points. */
+export function lengthToPoints(length) {
+    return length.value * POINTS_PER_UNIT[length.unit];
+}
+/** Convert a raw point count back to a tagged length in the requested unit. */
+export function pointsToLength(points, unit) {
+    return { value: points / POINTS_PER_UNIT[unit], unit };
+}
+export class LengthParseError extends Error {
+    constructor(input, reason) {
+        super(`invalid length "${input}": ${reason}`);
+        this.name = 'LengthParseError';
+    }
+}
+const LENGTH_RE = /^(-?\d+(?:\.\d+)?)([a-z]+)$/i;
+const KNOWN_UNITS = new Set(['pt', 'in', 'mm', 'cm']);
+/**
+ * Parse a unit-tagged length like `36pt`, `0.5in`, `10mm`, `1cm`.
+ *
+ * Throws `LengthParseError` on missing unit, unknown unit, non-numeric, zero,
+ * or negative values.
+ */
+export function parseLength(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        throw new LengthParseError(input, 'empty');
+    const match = LENGTH_RE.exec(trimmed);
+    if (!match) {
+        if (/^-?\d+(?:\.\d+)?$/.test(trimmed)) {
+            throw new LengthParseError(input, 'missing unit (expected pt, in, mm, or cm)');
+        }
+        throw new LengthParseError(input, 'expected <number><unit>');
+    }
+    const unit = match[2].toLowerCase();
+    if (!KNOWN_UNITS.has(unit)) {
+        throw new LengthParseError(input, `unknown unit "${unit}"; expected one of pt, in, mm, cm`);
+    }
+    const value = Number(match[1]);
+    if (!Number.isFinite(value))
+        throw new LengthParseError(input, 'non-numeric value');
+    if (value <= 0)
+        throw new LengthParseError(input, 'must be positive');
+    return { value, unit: unit };
+}
+//# sourceMappingURL=units.js.map

package/dist/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../src/units.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,yBAAyB;AAIzB,MAAM,eAAe,GAA4C;IAC7D,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,EAAE;IACN,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,eAAe;IAC9B,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,eAAe;CACjC,CAAC;AAEF,6CAA6C;AAC7C,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC5C,OAAO,MAAM,CAAC,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,IAAmB;IAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACvC,YAAY,KAAa,EAAE,MAAc;QACrC,KAAK,CAAC,mBAAmB,KAAK,MAAM,MAAM,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACnC,CAAC;CACJ;AAED,MAAM,SAAS,GAAG,8BAA8B,CAAC;AACjD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAErE;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,gBAAgB,CAAC,KAAK,EAAE,2CAA2C,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAqB,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,IAAI,mCAAmC,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACpF,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IACtE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAqB,EAAE,CAAC;AAClD,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@nowline/export-core",
+  "version": "0.2.0",
+  "description": "Nowline export-core — shared types, font resolver, unit converter, PDF page-size types",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./fonts": {
+      "types": "./dist/fonts/index.d.ts",
+      "import": "./dist/fonts/index.js"
+    },
+    "./units": {
+      "types": "./dist/units.d.ts",
+      "import": "./dist/units.js"
+    },
+    "./pdf-page": {
+      "types": "./dist/pdf-page.d.ts",
+      "import": "./dist/pdf-page.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "src/",
+    "assets/"
+  ],
+  "dependencies": {
+    "@nowline/layout": "0.2.0",
+    "@nowline/core": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "~5.7.0",
+    "vitest": "^3.1.0"
+  },
+  "scripts": {
+    "bundle-fonts": "node scripts/bundle-fonts.mjs",
+    "prebuild": "node scripts/bundle-fonts.mjs",
+    "build": "tsc -b tsconfig.json",
+    "watch": "tsc -b tsconfig.json --watch",
+    "pretest": "node scripts/bundle-fonts.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/ast-helpers.ts

@@ -0,0 +1,47 @@
+// Tiny AST property helpers shared by lossy exporters (Mermaid, MS Project,
+// XLSX). The Langium-generated AST stores DSL properties as
+// `EntityProperty[]` with `{ key, value?, values[] }`. Walking that shape
+// directly is verbose; these helpers keep the exporters readable.
+
+import type { EntityProperty, RoadmapDeclaration } from '@nowline/core';
+
+export type PropertyHost = {
+    properties?: EntityProperty[];
+    title?: string;
+    name?: string;
+};
+
+/** Return the single-value `value` for `key`, or undefined. */
+export function getProp(host: PropertyHost, key: string): string | undefined {
+    const prop = host.properties?.find((p) => p.key === key);
+    if (!prop) return undefined;
+    if (prop.value !== undefined) return prop.value;
+    if (prop.values && prop.values.length > 0) return prop.values[0];
+    return undefined;
+}
+
+/** Return the multi-value list for `key` (e.g. `after:[a, b]`), or empty. */
+export function getProps(host: PropertyHost, key: string): readonly string[] {
+    const prop = host.properties?.find((p) => p.key === key);
+    if (!prop) return [];
+    if (prop.values && prop.values.length > 0) return prop.values;
+    if (prop.value !== undefined) return [prop.value];
+    return [];
+}
+
+export function hasProp(host: PropertyHost, key: string): boolean {
+    return host.properties?.some((p) => p.key === key) ?? false;
+}
+
+/** Display label: title if present, otherwise name (id), otherwise '<unnamed>'. */
+export function displayLabel(host: PropertyHost): string {
+    if (host.title?.trim()) return host.title;
+    if (host.name?.trim()) return host.name;
+    return '<unnamed>';
+}
+
+/** Roadmap title falls back to declaration name. */
+export function roadmapTitle(decl: RoadmapDeclaration | undefined): string {
+    if (!decl) return 'Roadmap';
+    return decl.title?.trim() || decl.name?.trim() || 'Roadmap';
+}

package/src/fonts/bundled.ts

@@ -0,0 +1,59 @@
+// Bundled-fallback font loader.
+//
+// Spec: specs/handoffs/m2c.md § 10 "Bundled fallback".
+//
+// Ships exactly two TTFs under `assets/fonts/`: DejaVuSans.ttf (~740 KB) and
+// DejaVuSansMono.ttf (~330 KB). Bold / italic are synthesized by PDFKit's
+// faux-bold and skew transforms. License: see LICENSE-DejaVu.txt next to the
+// fonts.
+//
+// The TTF bytes are embedded as base64 string literals via
+// `scripts/bundle-fonts.mjs` (run as `prebuild` / `pretest`) so the loader
+// works under both Node and a bun --compile binary. `bun --compile` does not
+// virtualize fs.readFile of import.meta.url paths, so the on-disk asset is
+// invisible inside the compiled binary; the embedded strings are the
+// runtime source of truth.
+
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { MONO_BASE64, SANS_BASE64 } from '../generated/bundled-fonts.js';
+
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+
+// dist/fonts/bundled.js → ../../assets/fonts/
+//   src/fonts/bundled.ts → ../../assets/fonts/
+const ASSETS_DIR = path.resolve(HERE, '..', '..', 'assets', 'fonts');
+
+// Informational: where the source-of-truth TTFs live on disk for users
+// running under Node. Not the runtime load source — `loadBundledSans` and
+// `loadBundledMono` decode from the embedded base64 instead. Inside a bun
+// --compile binary these paths are phantom (the assets are not on disk).
+export const BUNDLED_SANS_PATH = path.join(ASSETS_DIR, 'DejaVuSans.ttf');
+export const BUNDLED_MONO_PATH = path.join(ASSETS_DIR, 'DejaVuSansMono.ttf');
+
+let cachedSans: Uint8Array | undefined;
+let cachedMono: Uint8Array | undefined;
+
+function decodeBase64(b64: string): Uint8Array {
+    const buf = Buffer.from(b64, 'base64');
+    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+}
+
+export async function loadBundledSans(): Promise<Uint8Array> {
+    if (cachedSans) return cachedSans;
+    cachedSans = decodeBase64(SANS_BASE64);
+    return cachedSans;
+}
+
+export async function loadBundledMono(): Promise<Uint8Array> {
+    if (cachedMono) return cachedMono;
+    cachedMono = decodeBase64(MONO_BASE64);
+    return cachedMono;
+}
+
+/** Test seam: drop cached bytes so platform-mocked tests start fresh. */
+export function clearBundledCache(): void {
+    cachedSans = undefined;
+    cachedMono = undefined;
+}

package/src/fonts/index.ts

@@ -0,0 +1,18 @@
+export {
+    BUNDLED_MONO_PATH,
+    BUNDLED_SANS_PATH,
+    clearBundledCache,
+    loadBundledMono,
+    loadBundledSans,
+} from './bundled.js';
+export {
+    ALIASES,
+    aliasCandidate,
+    type FontCandidate,
+    isAlias,
+    type PlatformProbe,
+    probeListFor,
+} from './probe-list.js';
+export type { ResolveOptions, ResolveResult } from './resolve.js';
+export { FontResolveError, resolveFonts } from './resolve.js';
+export { isVariableFontBytes } from './sfns.js';