postext 0.3.16 → 0.3.17

package/dist/__tests__/createLayout.test.js

@@ -24,22 +24,21 @@ describe("createLayout", () => {
             resources: [
                 {
                     id: "fig-1",
-                    type: "image",
-                    src: "/photo.jpg",
-                    alt: "A photo",
-                    caption: "Figure 1",
-                    width: 800,
-                    height: 600,
+                    typeId: "figure",
+                    kind: "bitmap",
+                    caption: "A photo",
+                    altText: "A photo",
+                    createdAt: 0,
+                    updatedAt: 0,
+                    bitmap: { fileId: "file-1", format: "jpeg", width: 800, height: 600 },
                 },
                 {
                     id: "tbl-1",
-                    type: "table",
-                    content: "| A | B |\n|---|---|\n| 1 | 2 |",
-                },
-                {
-                    id: "pq-1",
-                    type: "pullQuote",
-                    content: "A compelling quote.",
+                    typeId: "table",
+                    kind: "table",
+                    createdAt: 0,
+                    updatedAt: 0,
+                    table: { model: { rows: [[{ content: "A" }, { content: "B" }], [{ content: "1" }, { content: "2" }]] } },
                 },
             ],
         };

package/dist/__tests__/createLayout.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"createLayout.test.js","sourceRoot":"","sources":["../../src/__tests__/createLayout.test.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,MAAM,cAAc,GAAmB;QACrC,QAAQ,EAAE,iCAAiC;KAC5C,CAAC;IAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;QAC5C,iDAAiD;QACjD,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,OAAO,GAAmB;YAC9B,QAAQ,EAAE,iDAAiD;YAC3D,SAAS,EAAE;gBACT;oBACE,EAAE,EAAE,OAAO;oBACX,IAAI,EAAE,OAAO;oBACb,GAAG,EAAE,YAAY;oBACjB,GAAG,EAAE,SAAS;oBACd,OAAO,EAAE,UAAU;oBACnB,KAAK,EAAE,GAAG;oBACV,MAAM,EAAE,GAAG;iBACZ;gBACD;oBACE,EAAE,EAAE,OAAO;oBACX,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,iCAAiC;iBAC3C;gBACD;oBACE,EAAE,EAAE,MAAM;oBACV,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,qBAAqB;iBAC/B;aACF;SACF,CAAC;QACF,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,OAAO,GAAmB;YAC9B,QAAQ,EAAE,iCAAiC;YAC3C,KAAK,EAAE;gBACL,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE;gBACrE,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE;gBACvD,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE;aAC9D;SACF,CAAC;QACF,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAkB;YAC5B,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,MAAM;YACd,YAAY,EAAE;gBACZ,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,MAAM;gBACd,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE;gBAC3D,SAAS,EAAE,IAAI;aAChB;YACD,UAAU,EAAE;gBACV,OAAO,EAAE,CAAC;gBACV,MAAM,EAAE,CAAC;gBACT,WAAW,EAAE,IAAI;gBACjB,eAAe,EAAE,IAAI;gBACrB,OAAO,EAAE;oBACP,aAAa,EAAE,OAAO;oBACtB,YAAY,EAAE,OAAO;oBACrB,YAAY,EAAE,KAAK;oBACnB,WAAW,EAAE,KAAK;oBAClB,gBAAgB,EAAE,KAAK;oBACvB,eAAe,EAAE,KAAK;iBACvB;gBACD,YAAY,EAAE;oBACZ,oBAAoB,EAAE,IAAI;oBAC1B,iBAAiB,EAAE,IAAI;iBACxB;aACF;YACD,iBAAiB,EAAE;gBACjB,eAAe,EAAE,aAAa;gBAC9B,cAAc,EAAE,KAAK;gBACrB,mBAAmB,EAAE,IAAI;aAC1B;YACD,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE;gBAC1D,eAAe,EAAE,IAAI;gBACrB,cAAc,EAAE,IAAI;gBACpB,WAAW,EAAE,IAAI;aAClB;YACD,gBAAgB,EAAE;gBAChB;oBACE,QAAQ,EAAE,QAAQ;oBAClB,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;oBACrB,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;iBAC3B;aACF;YACD,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,UAAU,GAAG;YACjB,aAAa;YACb,QAAQ;YACR,WAAW;YACX,YAAY;YACZ,gBAAgB;YAChB,QAAQ;SACA,CAAC;QAEX,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,EAAE;gBAC1C,iBAAiB,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE;aACjD,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"createLayout.test.js","sourceRoot":"","sources":["../../src/__tests__/createLayout.test.tsx"],"names":[],"mappings":"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"}

package/dist/__tests__/defaults/resourceTypes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resourceTypes.test.d.ts.map

package/dist/__tests__/defaults/resourceTypes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceTypes.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/defaults/resourceTypes.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/defaults/resourceTypes.test.js

@@ -0,0 +1,69 @@
+import { describe, it, expect } from 'vitest';
+import { defaultResourceTypes } from '../../defaults/resourceTypes';
+import { parseMarkdown } from '../../parse';
+import { computeHeadingContext, computeResourceNumbering, } from '../../pipeline/resourceNumbering';
+const VALID_FORMATS = new Set([
+    'decimal',
+    'roman-lower',
+    'roman-upper',
+    'alpha-lower',
+    'alpha-upper',
+]);
+const VALID_RESETS = new Set(['never', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6']);
+describe('built-in resource types', () => {
+    it('returns a fresh array on every call (callers may mutate)', () => {
+        const a = defaultResourceTypes();
+        const b = defaultResourceTypes();
+        expect(a).not.toBe(b);
+        expect(a[0]).not.toBe(b[0]);
+        expect(a).toEqual(b);
+    });
+    it('has at least the figure and table types', () => {
+        const ids = defaultResourceTypes().map((t) => t.id);
+        expect(ids).toContain('figure');
+        expect(ids).toContain('table');
+    });
+    it('has unique ids', () => {
+        const ids = defaultResourceTypes().map((t) => t.id);
+        expect(new Set(ids).size).toBe(ids.length);
+    });
+    describe('every default type', () => {
+        const types = defaultResourceTypes();
+        for (const t of types) {
+            describe(`type "${t.id}"`, () => {
+                it('has a non-empty id, name and shortLabel', () => {
+                    expect(t.id.trim()).not.toBe('');
+                    expect(t.name.trim()).not.toBe('');
+                    expect(t.shortLabel.trim()).not.toBe('');
+                });
+                it('has a non-empty caption prefix', () => {
+                    expect(t.captionPrefix.trim()).not.toBe('');
+                });
+                it('has a valid counterFormat and resetOn', () => {
+                    expect(VALID_FORMATS.has(t.counterFormat)).toBe(true);
+                    expect(VALID_RESETS.has(t.resetOn)).toBe(true);
+                });
+                it('has a template that references the {n} counter', () => {
+                    expect(t.numberingTemplate).toContain('{n}');
+                });
+                it('renders a non-empty number through the numbering pipeline', () => {
+                    const resource = {
+                        id: 'r',
+                        typeId: t.id,
+                        kind: 'bitmap',
+                        createdAt: 0,
+                        updatedAt: 0,
+                        bitmap: { fileId: 'r.png', format: 'png', width: 1, height: 1 },
+                    };
+                    const md = '# Chapter\n\n::resource{id="r"}\n';
+                    const blocks = parseMarkdown(md);
+                    const ctx = computeHeadingContext(blocks);
+                    const map = computeResourceNumbering(blocks, [t], [resource], ctx);
+                    expect(map.r).toBeDefined();
+                    expect(map.r.number).not.toBe('');
+                });
+            });
+        }
+    });
+});
+//# sourceMappingURL=resourceTypes.test.js.map

package/dist/__tests__/defaults/resourceTypes.test.js.map

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

package/dist/__tests__/exports.test.js

@@ -1,5 +1,33 @@
 import { describe, it, expect } from "vitest";
 import * as postext from "../index";
+// Compile-time assertion that the resources/table public types are exported
+// from the package root (issue #49). These are type-only exports, so they do
+// not appear in `Object.keys(postext)`; this block fails the build (not the
+// runtime test) if any export is removed or renamed.
+const _resourceTypeChecks = () => {
+    const kind = "table";
+    const cell = { content: "x" };
+    const model = { rows: [[cell]] };
+    const type = {
+        id: "figure",
+        name: "Figure",
+        shortLabel: "Fig.",
+        numberingTemplate: "{n}",
+        resetOn: "never",
+        counterFormat: "decimal",
+        captionPrefix: "Figure",
+    };
+    const resource = {
+        id: "r",
+        typeId: type.id,
+        kind,
+        createdAt: 0,
+        updatedAt: 0,
+        table: { model },
+    };
+    return resource;
+};
+void _resourceTypeChecks;
 describe("package exports", () => {
     it("exports createLayout function", () => {
         expect(postext.createLayout).toBeDefined();
@@ -14,6 +42,10 @@ describe("package exports", () => {
             "renderToCanvas",
             "renderPage",
             "renderPageToCanvas",
+            "registerResourceImage",
+            "unregisterResourceImage",
+            "clearResourceImages",
+            "getResourceImage",
             "renderToHtml",
             "renderToHtmlIndexed",
             "dimensionToPx",
@@ -29,6 +61,15 @@ describe("package exports", () => {
             "hyphenateText",
             "setHyphenationLocale",
             "parseMarkdown",
+            "addRow",
+            "addColumn",
+            "removeRow",
+            "removeColumn",
+            "mergeCells",
+            "unmergeCell",
+            "setCellContent",
+            "setAlignment",
+            "parseTSV",
             "extractFrontmatter",
             "DEFAULT_PAGE_CONFIG",
             "DEFAULT_CUT_LINES",
@@ -47,6 +88,10 @@ describe("package exports", () => {
             "DEFAULT_HEADINGS_CONFIG",
             "resolveHeadingsConfig",
             "stripHeadingsDefaults",
+            "resolveTableStyleConfig",
+            "stripTableStyleDefaults",
+            "resolveCaptionStyleConfig",
+            "stripCaptionStyleDefaults",
             "DEFAULT_UNORDERED_LISTS_STATIC",
             "resolveUnorderedListsConfig",
             "stripUnorderedListsDefaults",
@@ -86,11 +131,20 @@ describe("package exports", () => {
             "DEFAULT_RULE_ELEMENT",
             "resolveHeaderFooterConfig",
             "stripHeaderFooterDefaults",
+            "defaultResourceTypes",
             "resolvePlaceholders",
             "computeChapterTitles",
             "collectPlaceholderNames",
             "isKnownPlaceholder",
             "isMetadataPlaceholder",
+            "resolveDesignPlaceholders",
+            "allowedPlaceholdersFor",
+            "layoutDesignSlot",
+            "migrateLegacyHeaderFooterConfig",
+            "isLegacyHeaderFooterSlot",
+            "resolveDesignSlot",
+            "stripDesignSlotDefaults",
+            "DEFAULT_BOX_ELEMENT",
             "parseMarkdownWithIssues",
             "MATH_PLACEHOLDER",
             "buildPageLabels",

package/dist/__tests__/exports.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"exports.test.js","sourceRoot":"","sources":["../../src/__tests__/exports.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,UAAU,CAAC;AAEpC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,CAAC,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;YAC3B,cAAc;YACd,eAAe;YACf,qBAAqB;YACrB,gBAAgB;YAChB,YAAY;YACZ,oBAAoB;YACpB,cAAc;YACd,qBAAqB;YACrB,eAAe;YACf,iBAAiB;YACjB,cAAc;YACd,kBAAkB;YAClB,mBAAmB;YACnB,gBAAgB;YAChB,uBAAuB;YACvB,wBAAwB;YACxB,oBAAoB;YACpB,wBAAwB;YACxB,eAAe;YACf,sBAAsB;YACtB,eAAe;YACf,oBAAoB;YACpB,qBAAqB;YACrB,mBAAmB;YACnB,wBAAwB;YACxB,mBAAmB;YACnB,mBAAmB;YACnB,uBAAuB;YACvB,qBAAqB;YACrB,qBAAqB;YACrB,qBAAqB;YACrB,0BAA0B;YAC1B,4BAA4B;YAC5B,uBAAuB;YACvB,uBAAuB;YACvB,kBAAkB;YAClB,yBAAyB;YACzB,uBAAuB;YACvB,uBAAuB;YACvB,gCAAgC;YAChC,6BAA6B;YAC7B,6BAA6B;YAC7B,8BAA8B;YAC9B,2BAA2B;YAC3B,2BAA2B;YAC3B,qBAAqB;YACrB,mBAAmB;YACnB,mBAAmB;YACnB,iBAAiB;YACjB,aAAa;YACb,mBAAmB;YACnB,sBAAsB;YACtB,8BAA8B;YAC9B,uBAAuB;YACvB,oBAAoB;YACpB,uBAAuB;YACvB,yBAAyB;YACzB,wBAAwB;YACxB,0BAA0B;YAC1B,uBAAuB;YACvB,mBAAmB;YACnB,qBAAqB;YACrB,sBAAsB;YACtB,oBAAoB;YACpB,oBAAoB;YACpB,4BAA4B;YAC5B,yBAAyB;YACzB,yBAAyB;YACzB,+BAA+B;YAC/B,4BAA4B;YAC5B,4BAA4B;YAC5B,4BAA4B;YAC5B,qBAAqB;YACrB,qBAAqB;YACrB,sBAAsB;YACtB,sBAAsB;YACtB,2BAA2B;YAC3B,2BAA2B;YAC3B,qBAAqB;YACrB,sBAAsB;YACtB,yBAAyB;YACzB,oBAAoB;YACpB,uBAAuB;YACvB,yBAAyB;YACzB,kBAAkB;YAClB,iBAAiB;YACjB,sBAAsB;YACtB,eAAe;YACf,gBAAgB;YAChB,aAAa;YACb,aAAa;YACb,YAAY;YACZ,mBAAmB;YACnB,gBAAgB;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"exports.test.js","sourceRoot":"","sources":["../../src/__tests__/exports.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/parse/inlineRef.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inlineRef.test.d.ts.map

package/dist/__tests__/parse/inlineRef.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineRef.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/parse/inlineRef.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/parse/inlineRef.test.js

@@ -0,0 +1,83 @@
+import { describe, it, expect } from 'vitest';
+import { parseMarkdown } from '../../parse';
+import { REF_PLACEHOLDER } from '../../parse/inlineFormatting';
+/** Collect all spans across all parsed blocks. */
+const allSpans = (md) => parseMarkdown(md).flatMap((b) => b.spans);
+const refSpans = (spans) => spans.filter((s) => s.ref);
+/** Total number of REF_PLACEHOLDER code points across every span's text. */
+const placeholderCount = (spans) => spans.reduce((sum, s) => sum + [...s.text].filter((ch) => ch === REF_PLACEHOLDER).length, 0);
+describe('inline :ref directive', () => {
+    it('parses a default :ref{id="x"}', () => {
+        const spans = allSpans('See :ref{id="fig-1"} for details.\n');
+        const refs = refSpans(spans);
+        expect(refs).toHaveLength(1);
+        expect(refs[0].ref).toEqual({ resourceId: 'fig-1' });
+        expect(refs[0].ref.style).toBeUndefined();
+    });
+    it('parses style="number"', () => {
+        const spans = allSpans('See :ref{id="x" style="number"}.\n');
+        const refs = refSpans(spans);
+        expect(refs).toHaveLength(1);
+        expect(refs[0].ref).toEqual({ resourceId: 'x', style: 'number' });
+    });
+    it('parses style="full"', () => {
+        const spans = allSpans('See :ref{id="x" style="full"}.\n');
+        expect(refSpans(spans)[0].ref).toEqual({ resourceId: 'x', style: 'full' });
+    });
+    it('parses style="default"', () => {
+        const spans = allSpans('See :ref{id="x" style="default"}.\n');
+        expect(refSpans(spans)[0].ref).toEqual({ resourceId: 'x', style: 'default' });
+    });
+    it('parses text="..." override', () => {
+        const spans = allSpans('See :ref{id="x" text="the chart"}.\n');
+        expect(refSpans(spans)[0].ref).toEqual({ resourceId: 'x', text: 'the chart' });
+    });
+    it('parses combined style and text attributes', () => {
+        const spans = allSpans('See :ref{id="x" style="full" text="Custom"}.\n');
+        expect(refSpans(spans)[0].ref).toEqual({
+            resourceId: 'x',
+            style: 'full',
+            text: 'Custom',
+        });
+    });
+    it('represents each ref as a single-placeholder span', () => {
+        const spans = allSpans('See :ref{id="x"}.\n');
+        const ref = refSpans(spans)[0];
+        expect(ref.text).toBe(REF_PLACEHOLDER);
+        expect([...ref.text]).toHaveLength(1);
+    });
+    describe('placeholder char count matches ref span count', () => {
+        const cases = [
+            'one :ref{id="a"} ref\n',
+            ':ref{id="a"} and :ref{id="b"} and :ref{id="c"}\n',
+            'mixed **bold :ref{id="a"}** and _italic :ref{id="b"}_\n',
+            'math $x^2$ then :ref{id="a"} then $y$ then :ref{id="b"}\n',
+            'no refs here at all\n',
+        ];
+        for (const md of cases) {
+            it(JSON.stringify(md), () => {
+                const spans = allSpans(md);
+                expect(placeholderCount(spans)).toBe(refSpans(spans).length);
+            });
+        }
+    });
+    it('keeps refs distinct from surrounding bold/italic spans', () => {
+        const spans = allSpans('**before :ref{id="a"} after**\n');
+        const refs = refSpans(spans);
+        expect(refs).toHaveLength(1);
+        // ref span inherits ambient bold
+        expect(refs[0].bold).toBe(true);
+        // surrounding text remains as its own bold spans
+        expect(spans.some((s) => !s.ref && s.bold && s.text.includes('before'))).toBe(true);
+    });
+    it('does not confuse refs with inline math placeholders', () => {
+        const spans = allSpans('$a$ :ref{id="x"} $b$\n');
+        const refs = refSpans(spans);
+        expect(refs).toHaveLength(1);
+        const mathSpans = spans.filter((s) => s.math);
+        expect(mathSpans).toHaveLength(2);
+        // each math span and each ref span is exactly one code point wide
+        expect(placeholderCount(spans)).toBe(1);
+    });
+});
+//# sourceMappingURL=inlineRef.test.js.map

package/dist/__tests__/parse/inlineRef.test.js.map

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

package/dist/__tests__/parse/resourceDirective.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resourceDirective.test.d.ts.map

package/dist/__tests__/parse/resourceDirective.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceDirective.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/parse/resourceDirective.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/parse/resourceDirective.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect } from 'vitest';
+import { parseMarkdown } from '../../parse';
+describe('::resource block directive', () => {
+    it('parses ::resource{id="x"} into a resourceBlock with the id', () => {
+        const blocks = parseMarkdown('::resource{id="fig-1"}\n');
+        expect(blocks).toHaveLength(1);
+        const block = blocks[0];
+        expect(block.type).toBe('resourceBlock');
+        expect(block.resourceId).toBe('fig-1');
+        expect(block.text).toBe('');
+        expect(block.spans).toEqual([]);
+    });
+    it('tolerates surrounding whitespace on the line', () => {
+        const blocks = parseMarkdown('   ::resource{id="abc"}   \n');
+        expect(blocks).toHaveLength(1);
+        expect(blocks[0].type).toBe('resourceBlock');
+        expect(blocks[0].resourceId).toBe('abc');
+    });
+    it('records the source span of the directive line', () => {
+        const blocks = parseMarkdown('::resource{id="r1"}\n');
+        const block = blocks[0];
+        expect(block.sourceStart).toBe(0);
+        expect(block.sourceEnd).toBeGreaterThan(block.sourceStart);
+    });
+    it('parses ids containing hyphens, dots and digits', () => {
+        const blocks = parseMarkdown('::resource{id="img.2024-final_3"}\n');
+        expect(blocks[0].type).toBe('resourceBlock');
+        expect(blocks[0].resourceId).toBe('img.2024-final_3');
+    });
+    describe('malformed variants fall through to paragraph', () => {
+        const cases = [
+            ['missing id attribute', '::resource{}\n'],
+            ['single-quoted id', "::resource{id='x'}\n"],
+            ['unquoted id', '::resource{id=x}\n'],
+            ['empty id value', '::resource{id=""}\n'],
+            ['no braces', '::resource id="x"\n'],
+            ['trailing junk after braces', '::resource{id="x"} extra\n'],
+            ['extra attribute inside braces', '::resource{id="x" foo="y"}\n'],
+            ['triple colon directive form', ':::resource{id="x"}\n'],
+            ['single colon', ':resource{id="x"}\n'],
+        ];
+        for (const [name, input] of cases) {
+            it(name, () => {
+                const blocks = parseMarkdown(input);
+                expect(blocks.every((b) => b.type !== 'resourceBlock')).toBe(true);
+                expect(blocks.some((b) => b.type === 'paragraph')).toBe(true);
+            });
+        }
+    });
+    it('does not treat ::resource embedded mid-paragraph as a block', () => {
+        const blocks = parseMarkdown('see ::resource{id="x"} here\n');
+        expect(blocks.every((b) => b.type !== 'resourceBlock')).toBe(true);
+    });
+});
+//# sourceMappingURL=resourceDirective.test.js.map

package/dist/__tests__/parse/resourceDirective.test.js.map

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

package/dist/__tests__/pipeline/floatPlacement.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=floatPlacement.test.d.ts.map

package/dist/__tests__/pipeline/floatPlacement.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floatPlacement.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/pipeline/floatPlacement.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/pipeline/floatPlacement.test.js

@@ -0,0 +1,141 @@
+import { describe, it, expect } from 'vitest';
+import { buildDocument } from '../../pipeline';
+import { computeFloatPlan, resolveResourcePlacement } from '../../pipeline/floatPlacement';
+import { parseMarkdown } from '../../parse';
+// Deterministic text measurement stub (no DOM in the node test env).
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+const figure = (id, placement) => ({
+    id,
+    typeId: 'figure',
+    kind: 'bitmap',
+    caption: `Figure ${id}.`,
+    createdAt: 0,
+    updatedAt: 0,
+    bitmap: { fileId: `${id}.png`, format: 'png', width: 400, height: 300 },
+    ...(placement ? { placement } : {}),
+});
+/** Small page so a few paragraphs overflow and a second page opens. */
+const smallPage = {
+    page: {
+        width: { value: 360, unit: 'pt' },
+        height: { value: 240, unit: 'pt' },
+        margins: { top: { value: 18, unit: 'pt' }, bottom: { value: 18, unit: 'pt' }, left: { value: 18, unit: 'pt' }, right: { value: 18, unit: 'pt' } },
+    },
+};
+const filler = (n) => Array.from({ length: n }, (_, i) => `Paragraph ${i} with enough words to consume vertical space and force the column and page to overflow so floats are flushed onto a freshly opened page during layout.`).join('\n\n');
+/** All float blocks across all pages. */
+const allFloats = (content, config) => {
+    const doc = buildDocument(content, config);
+    return doc.pages.flatMap((p) => (p.floats ?? []).map((b) => ({ page: p.index, block: b })));
+};
+/** Any inline (column-flow) resource block anywhere. */
+const inlineResourceBlocks = (content, config) => {
+    const doc = buildDocument(content, config);
+    return doc.pages.flatMap((p) => p.columns.flatMap((c) => c.blocks.filter((b) => b.type === 'resource')));
+};
+describe('float planning (pure)', () => {
+    it('resolves placement with resource > type > built-in default', () => {
+        const type = {
+            id: 'figure', name: 'Figure', shortLabel: 'Fig.', numberingTemplate: '{n}',
+            resetOn: 'never', counterFormat: 'decimal', captionPrefix: 'Figure',
+            defaultPlacement: { position: 'bottom', span: 'page' },
+        };
+        // Built-in default when nothing set.
+        expect(resolveResourcePlacement(figure('a'), undefined)).toEqual({ position: 'top', span: 'column' });
+        // Type default applies.
+        expect(resolveResourcePlacement(figure('a'), type)).toEqual({ position: 'bottom', span: 'page' });
+        // Resource overrides type.
+        expect(resolveResourcePlacement(figure('a', { position: 'top' }), type)).toEqual({ position: 'top', span: 'page' });
+    });
+    it('plans a float at the first reference, whether :ref or ::resource', () => {
+        const blocks = parseMarkdown('See :ref{id="f1"} here.\n\nMore text.\n\n::resource{id="f1"}');
+        const plan = computeFloatPlan(blocks, [figure('f1')], []);
+        expect(plan).toHaveLength(1);
+        expect(plan[0].resourceId).toBe('f1');
+        expect(plan[0].firstBlockIdx).toBe(0); // the :ref paragraph, not the later ::resource
+    });
+    it('excludes position:here resources from the plan', () => {
+        const blocks = parseMarkdown('::resource{id="f1"}');
+        const plan = computeFloatPlan(blocks, [figure('f1', { position: 'here' })], []);
+        expect(plan).toHaveLength(0);
+    });
+});
+describe('float placement in the build pipeline', () => {
+    it('floats a :ref-only resource to a page band, not inline, exactly once', () => {
+        const content = {
+            markdown: `# Intro\n\nText that mentions :ref{id="f1"} early on.\n\n${filler(20)}`,
+            resources: [figure('f1')],
+        };
+        const floats = allFloats(content, smallPage);
+        // Appears exactly once, as a float (not an inline column block).
+        expect(floats).toHaveLength(1);
+        expect(floats[0].block.resourceBlock?.resource.id).toBe('f1');
+        expect(inlineResourceBlocks(content, smallPage)).toHaveLength(0);
+    });
+    it('does not require a ::resource embed — the reference alone incorporates it', () => {
+        const withEmbed = {
+            markdown: `# Intro\n\nSee :ref{id="f1"}.\n\n${filler(20)}\n\n::resource{id="f1"}`,
+            resources: [figure('f1')],
+        };
+        const withoutEmbed = {
+            markdown: `# Intro\n\nSee :ref{id="f1"}.\n\n${filler(20)}`,
+            resources: [figure('f1')],
+        };
+        // Same single float either way; the embed is redundant for a floated resource.
+        expect(allFloats(withEmbed, smallPage)).toHaveLength(1);
+        expect(allFloats(withoutEmbed, smallPage)).toHaveLength(1);
+    });
+    it('keeps position:here resources inline at the directive', () => {
+        const content = {
+            markdown: `# Intro\n\nSee :ref{id="f1"}.\n\n::resource{id="f1"}\n\n${filler(4)}`,
+            resources: [figure('f1', { position: 'here' })],
+        };
+        expect(allFloats(content, smallPage)).toHaveLength(0);
+        expect(inlineResourceBlocks(content, smallPage).map((b) => b.resourceBlock?.resource.id)).toContain('f1');
+    });
+    it('a full-width (span:page) float is wider than a single-column float', () => {
+        const colDoc = allFloats({
+            markdown: `# Intro\n\n:ref{id="f1"}\n\n${filler(20)}`,
+            resources: [figure('f1', { span: 'column' })],
+        }, smallPage);
+        const pageDoc = allFloats({
+            markdown: `# Intro\n\n:ref{id="f1"}\n\n${filler(20)}`,
+            resources: [figure('f1', { span: 'page' })],
+        }, smallPage);
+        expect(colDoc).toHaveLength(1);
+        expect(pageDoc).toHaveLength(1);
+        expect(pageDoc[0].block.bbox.width).toBeGreaterThan(colDoc[0].block.bbox.width);
+    });
+    it('places a top float above body text and a bottom float below it', () => {
+        const doc = buildDocument({
+            markdown: `# Intro\n\nTop :ref{id="top"} and bottom :ref{id="bot"}.\n\n${filler(20)}`,
+            resources: [figure('top', { position: 'top' }), figure('bot', { position: 'bottom' })],
+        }, smallPage);
+        // Find the page that carries each float and compare to that page's column top.
+        for (const page of doc.pages) {
+            const contentTop = page.columns[0]?.bbox.y ?? 0;
+            for (const fb of page.floats ?? []) {
+                const id = fb.resourceBlock?.resource.id;
+                if (id === 'top') {
+                    // Top float sits at/above the (post-reservation) column top.
+                    expect(fb.bbox.y).toBeLessThanOrEqual(contentTop + 1);
+                }
+            }
+        }
+        // Both floats placed.
+        const ids = doc.pages.flatMap((p) => (p.floats ?? []).map((b) => b.resourceBlock?.resource.id));
+        expect(ids).toContain('top');
+        expect(ids).toContain('bot');
+    });
+});
+//# sourceMappingURL=floatPlacement.test.js.map

package/dist/__tests__/pipeline/floatPlacement.test.js.map

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

package/dist/__tests__/pipeline/inlineRefRender.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inlineRefRender.test.d.ts.map

package/dist/__tests__/pipeline/inlineRefRender.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineRefRender.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/pipeline/inlineRefRender.test.ts"],"names":[],"mappings":""}