@formfeed/engine 0.3.9 → 0.3.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formfeed/engine",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "description": "The Formfeed template engine (Jinja2, Liquid, Handlebars) for the browser and Node.",
   "license": "MIT",
   "type": "module",

package/types/frame/fit.d.cts

@@ -0,0 +1,13 @@
+/**
+ * Fit text to its box (plan 16 §4.3): an element with `data-ff-fit="shrink"` and a fixed size gets
+ * the largest font size between its own CSS size and `data-ff-fit-min` (px) at which its text fits.
+ * `assembleDocument` adds this script when a document contains the attribute. It runs once the fonts
+ * are loaded and again whenever `window.formfeedFit()` is called: the paged preview after Paged.js,
+ * the design stage after a stylesheet change, the render-worker before it captures. Every run starts
+ * from the CSS size, so it is idempotent. Bundled by `engine:frames`; keep it self-contained.
+ */
+export declare function fits(box: HTMLElement, text: HTMLElement, win: Window): boolean;
+export declare function fitBox(box: HTMLElement, win: Window): number;
+export declare function installFit(win: Window & {
+    formfeedFit?: () => void;
+}): void;

package/types/frame/fit.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Fit text to its box (plan 16 §4.3): an element with `data-ff-fit="shrink"` and a fixed size gets
+ * the largest font size between its own CSS size and `data-ff-fit-min` (px) at which its text fits.
+ * `assembleDocument` adds this script when a document contains the attribute. It runs once the fonts
+ * are loaded and again whenever `window.formfeedFit()` is called: the paged preview after Paged.js,
+ * the design stage after a stylesheet change, the render-worker before it captures. Every run starts
+ * from the CSS size, so it is idempotent. Bundled by `engine:frames`; keep it self-contained.
+ */
+export declare function fits(box: HTMLElement, text: HTMLElement, win: Window): boolean;
+export declare function fitBox(box: HTMLElement, win: Window): number;
+export declare function installFit(win: Window & {
+    formfeedFit?: () => void;
+}): void;

package/types/frame/fit.entry.d.cts

@@ -0,0 +1 @@
+export {};

package/types/frame/fit.entry.d.ts

@@ -0,0 +1 @@
+export {};

package/types/frame/stage.d.cts

@@ -0,0 +1,22 @@
+/**
+ * The runtime of the design stage's frame (plan 16 §4.6). The frame shows the emitted template and
+ * takes no pointer events: the editor draws selection and handles in an overlay and talks to the
+ * frame by message. Bundled by `engine:frames`; keep it self-contained.
+ *
+ * - `formfeed:ready` (frame → editor), once the fonts are loaded and text is fitted, and again after
+ *   every stylesheet patch: each layer's laid-out size and whether its text overflows its box.
+ * - `formfeed:layer-style` (editor → frame): position, size and rotation of one layer during a drag,
+ *   applied inline; `formfeed:layer-style-clear` drops them.
+ * - `formfeed:css`: the template's stylesheet replaced in place, without a reload.
+ * - The edit session of `text-edit.ts`, addressed by layer, for typing in place.
+ */
+export interface StageLayerBox {
+    id: string;
+    width: number;
+    height: number;
+    overflow: boolean;
+}
+export declare function measureLayers(doc: Document, win: Window): StageLayerBox[];
+export declare function installStage(win: Window & {
+    formfeedFit?: () => void;
+}): void;

package/types/frame/stage.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The runtime of the design stage's frame (plan 16 §4.6). The frame shows the emitted template and
+ * takes no pointer events: the editor draws selection and handles in an overlay and talks to the
+ * frame by message. Bundled by `engine:frames`; keep it self-contained.
+ *
+ * - `formfeed:ready` (frame → editor), once the fonts are loaded and text is fitted, and again after
+ *   every stylesheet patch: each layer's laid-out size and whether its text overflows its box.
+ * - `formfeed:layer-style` (editor → frame): position, size and rotation of one layer during a drag,
+ *   applied inline; `formfeed:layer-style-clear` drops them.
+ * - `formfeed:css`: the template's stylesheet replaced in place, without a reload.
+ * - The edit session of `text-edit.ts`, addressed by layer, for typing in place.
+ */
+export interface StageLayerBox {
+    id: string;
+    width: number;
+    height: number;
+    overflow: boolean;
+}
+export declare function measureLayers(doc: Document, win: Window): StageLayerBox[];
+export declare function installStage(win: Window & {
+    formfeedFit?: () => void;
+}): void;

package/types/frame/stage.entry.d.cts

@@ -0,0 +1 @@
+export {};

package/types/frame/stage.entry.d.ts

@@ -0,0 +1 @@
+export {};

package/types/frame/text-edit.d.cts

@@ -0,0 +1,75 @@
+/**
+ * The edit session inside a preview frame (plan 16 §3.3). Bundled by `engine:frames` into
+ * `lib/generated/frames.ts` and injected into the flow and paged previews while the editor's edit
+ * mode is on, so it must stay self-contained: no imports but types, nothing from module scope that a
+ * bundler would not inline.
+ *
+ * A click on an element marked `data-ff-edit` asks the editor (`formfeed:edit-request`); the editor
+ * answers with the items to show (`formfeed:edit-begin`) or a refusal. While editing, text is typed
+ * in place, chips are atomic, and Enter, Tab or leaving the element commit
+ * (`formfeed:edit-commit`), Escape cancels. The frame never writes the template: it only sends what
+ * the user typed. Ctrl+B, Ctrl+I and Ctrl+U format nothing here; on the design stage they are passed
+ * on (`formfeed:edit-style`), where they switch the style of the whole layer.
+ */
+/** An item as the frame shows it: chips carry the text to display. */
+export type FrameItem = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'chip';
+    index: number;
+    text: string;
+    title?: string;
+} | {
+    kind: 'break';
+};
+/** What the frame sends back: chips by index only. */
+export type FrameEditItem = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'chip';
+    index: number;
+} | {
+    kind: 'break';
+};
+export interface EditBegin {
+    type: 'formfeed:edit-begin';
+    token: string;
+    src: string;
+    /** A design layer instead of a source position: its `.ff-text` is edited (the canvas, plan 16 §4.6). */
+    layer?: string;
+    /**
+     * Where the caret goes, in this document's viewport px. The canvas takes its clicks on an overlay
+     * outside the frame, so it says where the click was; without it the caret goes to the end.
+     */
+    at?: {
+        x: number;
+        y: number;
+    };
+    /** Text to type first: the key that started the session on the canvas (select a text, then type). */
+    insert?: string;
+    /** Starts with the whole text selected, so typing replaces it: a text added a moment ago holds a placeholder. */
+    select?: 'all';
+    items: FrameItem[];
+    allowBreaks: boolean;
+    /** Shown beside the element while editing ("Changes all 12"). */
+    note?: string;
+    label?: string;
+}
+export interface TextEditOptions {
+    /**
+     * The preview's edit mode: a click on marked text asks the editor, and undo keys are forwarded.
+     * The design stage starts sessions itself (its frame takes no pointer events), so it turns this off.
+     */
+    clicks?: boolean;
+    /**
+     * The design stage: report the items on every change (`formfeed:edit-input`), so what was typed
+     * survives a frame that goes away before its session commits (the stage is rebuilt when the editor
+     * switches panels, and the commit would reach no one).
+     */
+    live?: boolean;
+}
+export declare function installTextEdit(win: Window, options?: TextEditOptions): void;
+/** The element's content as items: text, chips by index, breaks; anything the browser added is flattened. */
+export declare function serialize(element: Element): FrameEditItem[];

package/types/frame/text-edit.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The edit session inside a preview frame (plan 16 §3.3). Bundled by `engine:frames` into
+ * `lib/generated/frames.ts` and injected into the flow and paged previews while the editor's edit
+ * mode is on, so it must stay self-contained: no imports but types, nothing from module scope that a
+ * bundler would not inline.
+ *
+ * A click on an element marked `data-ff-edit` asks the editor (`formfeed:edit-request`); the editor
+ * answers with the items to show (`formfeed:edit-begin`) or a refusal. While editing, text is typed
+ * in place, chips are atomic, and Enter, Tab or leaving the element commit
+ * (`formfeed:edit-commit`), Escape cancels. The frame never writes the template: it only sends what
+ * the user typed. Ctrl+B, Ctrl+I and Ctrl+U format nothing here; on the design stage they are passed
+ * on (`formfeed:edit-style`), where they switch the style of the whole layer.
+ */
+/** An item as the frame shows it: chips carry the text to display. */
+export type FrameItem = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'chip';
+    index: number;
+    text: string;
+    title?: string;
+} | {
+    kind: 'break';
+};
+/** What the frame sends back: chips by index only. */
+export type FrameEditItem = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'chip';
+    index: number;
+} | {
+    kind: 'break';
+};
+export interface EditBegin {
+    type: 'formfeed:edit-begin';
+    token: string;
+    src: string;
+    /** A design layer instead of a source position: its `.ff-text` is edited (the canvas, plan 16 §4.6). */
+    layer?: string;
+    /**
+     * Where the caret goes, in this document's viewport px. The canvas takes its clicks on an overlay
+     * outside the frame, so it says where the click was; without it the caret goes to the end.
+     */
+    at?: {
+        x: number;
+        y: number;
+    };
+    /** Text to type first: the key that started the session on the canvas (select a text, then type). */
+    insert?: string;
+    /** Starts with the whole text selected, so typing replaces it: a text added a moment ago holds a placeholder. */
+    select?: 'all';
+    items: FrameItem[];
+    allowBreaks: boolean;
+    /** Shown beside the element while editing ("Changes all 12"). */
+    note?: string;
+    label?: string;
+}
+export interface TextEditOptions {
+    /**
+     * The preview's edit mode: a click on marked text asks the editor, and undo keys are forwarded.
+     * The design stage starts sessions itself (its frame takes no pointer events), so it turns this off.
+     */
+    clicks?: boolean;
+    /**
+     * The design stage: report the items on every change (`formfeed:edit-input`), so what was typed
+     * survives a frame that goes away before its session commits (the stage is rebuilt when the editor
+     * switches panels, and the commit would reach no one).
+     */
+    live?: boolean;
+}
+export declare function installTextEdit(win: Window, options?: TextEditOptions): void;
+/** The element's content as items: text, chips by index, breaks; anything the browser added is flattened. */
+export declare function serialize(element: Element): FrameEditItem[];

package/types/frame/text-edit.entry.d.cts

@@ -0,0 +1 @@
+export {};

package/types/frame/text-edit.entry.d.ts

@@ -0,0 +1 @@
+export {};

package/types/index.d.cts

@@ -2,33 +2,40 @@ export * from './lib/types.cjs';
 export { EngineSyntaxError, RenderError, RenderLimitError } from './lib/errors.cjs';
 export { defaultLimits, depthGuard, enforceLimits } from './lib/limits.cjs';
 export { DefaultHelperRegistry, EPC_MAX_BYTES, builtinHelpers, chartMarkup, chartPayload, createHelperRegistry, defaultHelpers, epcPayload, escapeHtml, helperDocs, ibanChecksum, imageMarkup, normaliseIban, qrSvg, svgDataUri, toDate, toNumber, validateEpc, } from './lib/helpers/index.cjs';
-export type { EpcInput, EpcPayment, EpcProblem, QrOptions } from './lib/helpers/index.cjs';
+export type { EpcInput, EpcPayment, EpcProblem, QrOptions, } from './lib/helpers/index.cjs';
 export { analyzeHandlebars, analyzeJinja2, analyzeLiquid, engineIds, engines, getEngine, handlebarsEngine, jinja2Engine, liquidEngine, liquidBuiltinFilters, nunjucksBuiltinFilters, } from './lib/engines/index.cjs';
-export { diffSchemas, inferSchema, inferSchemaFromDataSets, schemaPaths } from './lib/schema.cjs';
+export { diffSchemas, inferSchema, inferSchemaFromDataSets, schemaPaths, } from './lib/schema.cjs';
 export { defaultOutput, imageOutput, isOfficeKind, isOutputFormat, officeKinds, outputFormats, outputsForKind, type OfficeKind, type OutputFormat, } from './lib/output.cjs';
-export { brandCss, emptyBrand, layeredPartials, normalisePartialName } from './lib/brand.cjs';
+export { brandCss, emptyBrand, layeredPartials, normalisePartialName, } from './lib/brand.cjs';
 export type { BrandContext, SharedPartial } from './lib/brand.cjs';
 export { mergeSampleData, mergeSnippetCss, mergeSnippetI18n, partialInclude, snippets, snippetsFor, snippetText, } from './lib/snippets.cjs';
 export { apitemplateRegions, importApitemplate, importApitemplateFromApi, isApitemplateHtmlTemplate, isApitemplateRegion, slugFromName, splitApitemplateCss, } from './lib/import/apitemplate.cjs';
-export type { ApitemplateApiTemplate, ApitemplateExport, ApitemplateListItem, ApitemplateRegion } from './lib/import/apitemplate.cjs';
-export type { ImportNote, ImportResult, ImportSource } from './lib/import/common.cjs';
+export type { ApitemplateApiTemplate, ApitemplateExport, ApitemplateListItem, ApitemplateRegion, } from './lib/import/apitemplate.cjs';
+export type { ImportNote, ImportResult, ImportSource, } from './lib/import/common.cjs';
 export { importPdfmonkey, strftimeToDateFns } from './lib/import/pdfmonkey.cjs';
-export type { PdfmonkeyImportOptions, PdfmonkeySettings, PdfmonkeyTemplate } from './lib/import/pdfmonkey.cjs';
-export { importJsreport, jsreportTemplates, readJsreportExport } from './lib/import/jsreport.cjs';
-export type { JsreportBundle, JsreportImportOptions, JsreportTemplate } from './lib/import/jsreport.cjs';
+export type { PdfmonkeyImportOptions, PdfmonkeySettings, PdfmonkeyTemplate, } from './lib/import/pdfmonkey.cjs';
+export { importJsreport, jsreportTemplates, readJsreportExport, } from './lib/import/jsreport.cjs';
+export type { JsreportBundle, JsreportImportOptions, JsreportTemplate, } from './lib/import/jsreport.cjs';
 export { convertScss, isScss } from './lib/import/scss.cjs';
 export type { Snippet, SnippetGroup } from './lib/snippets.cjs';
-export type { JsonSchema, SchemaChange, SchemaChangeKind, SchemaDiff } from './lib/schema.cjs';
+export type { JsonSchema, SchemaChange, SchemaChangeKind, SchemaDiff, } from './lib/schema.cjs';
 export { DEFAULT_CHROME_PADDING, assembleDocument, chartInitScript, defaultSettings, fontFaceCss, mergeSettings, pageSize, printReset, renderVersion, } from './lib/assemble.cjs';
 export type { ChartSpec, ImageOptions } from './lib/helpers/index.cjs';
-export { flowDocument, pagedDocument, pageNumberSpans, paperOf, zoomGestureScript } from './lib/preview.cjs';
-export type { PagedOptions, PreviewOverflow, RenderedDraft } from './lib/preview.cjs';
-export { annotateSourcePositions, parseSourceAttribute, sourceAttribute, } from './lib/source-positions.cjs';
-export type { SourceFile, SourceLocation } from './lib/source-positions.cjs';
+export { canvasDocument, flowDocument, pagedDocument, pageNumberSpans, paperOf, zoomGestureScript, } from './lib/preview.cjs';
+export type { PagedOptions, PreviewOptions, PreviewOverflow, RenderedDraft, } from './lib/preview.cjs';
+export { annotateSourcePositions, editAttribute, parseSourceAttribute, sourceAttribute, } from './lib/source-positions.cjs';
+export type { AnnotateOptions, SourceFile, SourceLocation, } from './lib/source-positions.cjs';
+export { applyRegionEdit, chipValues, editableRegion, editableRegionAt, findRegionAgain, regionChips, regionItems, translationItems, translationText, } from './lib/source-edit.cjs';
+export type { ApplyResult, ChipKind, EditableRegion, EditItem, RegionChip, RegionLookup, RegionPart, RegionRefusal, } from './lib/source-edit.cjs';
+export { resolveTranslation, translationTarget } from './lib/translation.cjs';
+export { DESIGN_LIMITS, DESIGN_VERSION, dataPathPattern, defaultLayer, designBytes, designOutputHash, designStarters, emitDesign, emptyDesign, genericFamily, googleFont, googleFonts, googleFontsUrl, imageIsEmpty, layerIdPattern, nearestWeight, nextLayerId, parseDesign, } from './lib/design/index.cjs';
+export type { BarcodeLayer, BarcodeSymbology, Binding, CanvasSize, DesignDocument, DesignLayer, DesignStarter, EmittedDesign, FontChoice, GoogleFont, ImageLayer, ImageSource, LayerBase, LayerType, Paint, ParsedDesign, QrLayer, Shadow, ShapeLayer, Stroke, TextFormat, TextItem, TextLayer, TextStyle, } from './lib/design/index.cjs';
+export { encodeTemplateText } from './lib/source-edit.cjs';
+export type { Dictionaries } from './lib/translation.cjs';
 export type { AssembleExtras, AssembleInput, AssembleVendor, FontFace, HeaderFooterSettings, RenderedDocument, TemplateKind, TemplateSettings, VersionSource, } from './lib/assemble.cjs';
 export { resolvePath, scanBlocks, jinjaTags, liquidTags, } from './lib/analysis/tags.cjs';
 export { OFFICE_FILLED_MAX_BYTES, OfficeTemplateError, analyzeOffice, officeTextParts, renderOffice, type OfficeAnalysis, type OfficeAnalysisDiagnostic, type OfficeRenderOptions, type OfficeRenderResult, } from './lib/office/render.cjs';
 export type { OfficeTag } from './lib/office/tags.cjs';
 export { starterDocument } from './lib/office/starter.cjs';
 export { starterPresentation } from './lib/office/starter-pptx.cjs';
-export { officeDrawingLimits, type OfficeImageHost } from './lib/office/drawings.cjs';
+export { officeDrawingLimits, type OfficeImageHost, } from './lib/office/drawings.cjs';

package/types/index.d.ts

@@ -2,33 +2,40 @@ export * from './lib/types.js';
 export { EngineSyntaxError, RenderError, RenderLimitError } from './lib/errors.js';
 export { defaultLimits, depthGuard, enforceLimits } from './lib/limits.js';
 export { DefaultHelperRegistry, EPC_MAX_BYTES, builtinHelpers, chartMarkup, chartPayload, createHelperRegistry, defaultHelpers, epcPayload, escapeHtml, helperDocs, ibanChecksum, imageMarkup, normaliseIban, qrSvg, svgDataUri, toDate, toNumber, validateEpc, } from './lib/helpers/index.js';
-export type { EpcInput, EpcPayment, EpcProblem, QrOptions } from './lib/helpers/index.js';
+export type { EpcInput, EpcPayment, EpcProblem, QrOptions, } from './lib/helpers/index.js';
 export { analyzeHandlebars, analyzeJinja2, analyzeLiquid, engineIds, engines, getEngine, handlebarsEngine, jinja2Engine, liquidEngine, liquidBuiltinFilters, nunjucksBuiltinFilters, } from './lib/engines/index.js';
-export { diffSchemas, inferSchema, inferSchemaFromDataSets, schemaPaths } from './lib/schema.js';
+export { diffSchemas, inferSchema, inferSchemaFromDataSets, schemaPaths, } from './lib/schema.js';
 export { defaultOutput, imageOutput, isOfficeKind, isOutputFormat, officeKinds, outputFormats, outputsForKind, type OfficeKind, type OutputFormat, } from './lib/output.js';
-export { brandCss, emptyBrand, layeredPartials, normalisePartialName } from './lib/brand.js';
+export { brandCss, emptyBrand, layeredPartials, normalisePartialName, } from './lib/brand.js';
 export type { BrandContext, SharedPartial } from './lib/brand.js';
 export { mergeSampleData, mergeSnippetCss, mergeSnippetI18n, partialInclude, snippets, snippetsFor, snippetText, } from './lib/snippets.js';
 export { apitemplateRegions, importApitemplate, importApitemplateFromApi, isApitemplateHtmlTemplate, isApitemplateRegion, slugFromName, splitApitemplateCss, } from './lib/import/apitemplate.js';
-export type { ApitemplateApiTemplate, ApitemplateExport, ApitemplateListItem, ApitemplateRegion } from './lib/import/apitemplate.js';
-export type { ImportNote, ImportResult, ImportSource } from './lib/import/common.js';
+export type { ApitemplateApiTemplate, ApitemplateExport, ApitemplateListItem, ApitemplateRegion, } from './lib/import/apitemplate.js';
+export type { ImportNote, ImportResult, ImportSource, } from './lib/import/common.js';
 export { importPdfmonkey, strftimeToDateFns } from './lib/import/pdfmonkey.js';
-export type { PdfmonkeyImportOptions, PdfmonkeySettings, PdfmonkeyTemplate } from './lib/import/pdfmonkey.js';
-export { importJsreport, jsreportTemplates, readJsreportExport } from './lib/import/jsreport.js';
-export type { JsreportBundle, JsreportImportOptions, JsreportTemplate } from './lib/import/jsreport.js';
+export type { PdfmonkeyImportOptions, PdfmonkeySettings, PdfmonkeyTemplate, } from './lib/import/pdfmonkey.js';
+export { importJsreport, jsreportTemplates, readJsreportExport, } from './lib/import/jsreport.js';
+export type { JsreportBundle, JsreportImportOptions, JsreportTemplate, } from './lib/import/jsreport.js';
 export { convertScss, isScss } from './lib/import/scss.js';
 export type { Snippet, SnippetGroup } from './lib/snippets.js';
-export type { JsonSchema, SchemaChange, SchemaChangeKind, SchemaDiff } from './lib/schema.js';
+export type { JsonSchema, SchemaChange, SchemaChangeKind, SchemaDiff, } from './lib/schema.js';
 export { DEFAULT_CHROME_PADDING, assembleDocument, chartInitScript, defaultSettings, fontFaceCss, mergeSettings, pageSize, printReset, renderVersion, } from './lib/assemble.js';
 export type { ChartSpec, ImageOptions } from './lib/helpers/index.js';
-export { flowDocument, pagedDocument, pageNumberSpans, paperOf, zoomGestureScript } from './lib/preview.js';
-export type { PagedOptions, PreviewOverflow, RenderedDraft } from './lib/preview.js';
-export { annotateSourcePositions, parseSourceAttribute, sourceAttribute, } from './lib/source-positions.js';
-export type { SourceFile, SourceLocation } from './lib/source-positions.js';
+export { canvasDocument, flowDocument, pagedDocument, pageNumberSpans, paperOf, zoomGestureScript, } from './lib/preview.js';
+export type { PagedOptions, PreviewOptions, PreviewOverflow, RenderedDraft, } from './lib/preview.js';
+export { annotateSourcePositions, editAttribute, parseSourceAttribute, sourceAttribute, } from './lib/source-positions.js';
+export type { AnnotateOptions, SourceFile, SourceLocation, } from './lib/source-positions.js';
+export { applyRegionEdit, chipValues, editableRegion, editableRegionAt, findRegionAgain, regionChips, regionItems, translationItems, translationText, } from './lib/source-edit.js';
+export type { ApplyResult, ChipKind, EditableRegion, EditItem, RegionChip, RegionLookup, RegionPart, RegionRefusal, } from './lib/source-edit.js';
+export { resolveTranslation, translationTarget } from './lib/translation.js';
+export { DESIGN_LIMITS, DESIGN_VERSION, dataPathPattern, defaultLayer, designBytes, designOutputHash, designStarters, emitDesign, emptyDesign, genericFamily, googleFont, googleFonts, googleFontsUrl, imageIsEmpty, layerIdPattern, nearestWeight, nextLayerId, parseDesign, } from './lib/design/index.js';
+export type { BarcodeLayer, BarcodeSymbology, Binding, CanvasSize, DesignDocument, DesignLayer, DesignStarter, EmittedDesign, FontChoice, GoogleFont, ImageLayer, ImageSource, LayerBase, LayerType, Paint, ParsedDesign, QrLayer, Shadow, ShapeLayer, Stroke, TextFormat, TextItem, TextLayer, TextStyle, } from './lib/design/index.js';
+export { encodeTemplateText } from './lib/source-edit.js';
+export type { Dictionaries } from './lib/translation.js';
 export type { AssembleExtras, AssembleInput, AssembleVendor, FontFace, HeaderFooterSettings, RenderedDocument, TemplateKind, TemplateSettings, VersionSource, } from './lib/assemble.js';
 export { resolvePath, scanBlocks, jinjaTags, liquidTags, } from './lib/analysis/tags.js';
 export { OFFICE_FILLED_MAX_BYTES, OfficeTemplateError, analyzeOffice, officeTextParts, renderOffice, type OfficeAnalysis, type OfficeAnalysisDiagnostic, type OfficeRenderOptions, type OfficeRenderResult, } from './lib/office/render.js';
 export type { OfficeTag } from './lib/office/tags.js';
 export { starterDocument } from './lib/office/starter.js';
 export { starterPresentation } from './lib/office/starter-pptx.js';
-export { officeDrawingLimits, type OfficeImageHost } from './lib/office/drawings.js';
+export { officeDrawingLimits, type OfficeImageHost, } from './lib/office/drawings.js';

package/types/lib/assemble.d.cts

@@ -70,6 +70,11 @@ export interface TemplateSettings {
         text?: string;
         opacity?: number;
     } | null;
+    /**
+     * The visual editor's document (plan 16 §4.1, `DesignDocument` once `parseDesign` accepted it). It
+     * is authoring data: nothing renders it, the version's HTML and CSS are what it emitted.
+     */
+    design?: unknown;
 }
 export type TemplateKind = 'pdf' | 'image';
 export declare function defaultSettings(): Required<Pick<TemplateSettings, 'paper' | 'margin' | 'printBackground' | 'scale' | 'preferCssPageSize' | 'locale' | 'timezone' | 'currency'>> & TemplateSettings;

package/types/lib/assemble.d.ts

@@ -70,6 +70,11 @@ export interface TemplateSettings {
         text?: string;
         opacity?: number;
     } | null;
+    /**
+     * The visual editor's document (plan 16 §4.1, `DesignDocument` once `parseDesign` accepted it). It
+     * is authoring data: nothing renders it, the version's HTML and CSS are what it emitted.
+     */
+    design?: unknown;
 }
 export type TemplateKind = 'pdf' | 'image';
 export declare function defaultSettings(): Required<Pick<TemplateSettings, 'paper' | 'margin' | 'printBackground' | 'scale' | 'preferCssPageSize' | 'locale' | 'timezone' | 'currency'>> & TemplateSettings;

package/types/lib/design/emit.d.cts

@@ -0,0 +1,20 @@
+import type { EngineId } from '../types.cjs';
+import type { CanvasSize, DesignDocument } from './types.cjs';
+/**
+ * A design as the template it stands for (plan 16 §4.2): the body and the CSS in the template's
+ * engine, deterministic, so the output hashes and diffs stably. Structure goes into the HTML (one
+ * line per layer) and presentation into the CSS, so moving or restyling a layer changes only the
+ * stylesheet. Values that reach CSS were checked by `parseDesign` and are checked again here.
+ */
+export interface EmittedDesign {
+    html: string;
+    css: string;
+    /** Each layer's line range (1-based, inclusive) in `html`, to show a diagnostic on its layer. */
+    map: Record<string, {
+        start: number;
+        end: number;
+    }>;
+    /** `designOutputHash(html, css)`: what the design records as `output`. */
+    output: string;
+}
+export declare function emitDesign(design: DesignDocument, engine: EngineId, size: CanvasSize): EmittedDesign;

package/types/lib/design/emit.d.ts

@@ -0,0 +1,20 @@
+import type { EngineId } from '../types.js';
+import type { CanvasSize, DesignDocument } from './types.js';
+/**
+ * A design as the template it stands for (plan 16 §4.2): the body and the CSS in the template's
+ * engine, deterministic, so the output hashes and diffs stably. Structure goes into the HTML (one
+ * line per layer) and presentation into the CSS, so moving or restyling a layer changes only the
+ * stylesheet. Values that reach CSS were checked by `parseDesign` and are checked again here.
+ */
+export interface EmittedDesign {
+    html: string;
+    css: string;
+    /** Each layer's line range (1-based, inclusive) in `html`, to show a diagnostic on its layer. */
+    map: Record<string, {
+        start: number;
+        end: number;
+    }>;
+    /** `designOutputHash(html, css)`: what the design records as `output`. */
+    output: string;
+}
+export declare function emitDesign(design: DesignDocument, engine: EngineId, size: CanvasSize): EmittedDesign;

package/types/lib/design/fonts.d.cts

@@ -0,0 +1,27 @@
+/**
+ * The Google Fonts a design can pick (plan 16 §4.2, §9): a curated list, so the one `@import` the
+ * emitter writes only ever names families and weights Google serves — an unknown family or a weight
+ * a family lacks makes Google answer 400, and every font of the design would be missing. The
+ * render-worker's asset cache serves the stylesheet and the files like any other Google Fonts request.
+ */
+export interface GoogleFont {
+    family: string;
+    category: 'sans-serif' | 'serif' | 'display' | 'monospace' | 'handwriting';
+    weights: number[];
+    italic: boolean;
+}
+export declare const googleFonts: GoogleFont[];
+export declare function googleFont(family: string): GoogleFont | undefined;
+/** The generic family a font falls back to in CSS. */
+export declare function genericFamily(font: GoogleFont | undefined): string;
+/** The weight a family serves that is closest to the one asked for (heavier on a tie). */
+export declare function nearestWeight(font: GoogleFont, weight: number): number;
+/**
+ * One stylesheet URL for every family, weight and style a design uses, or null when it uses none.
+ * `display=block`, so a capture never shows a fallback font.
+ */
+export declare function googleFontsUrl(uses: Array<{
+    family: string;
+    weight: number;
+    italic: boolean;
+}>): string | null;

package/types/lib/design/fonts.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The Google Fonts a design can pick (plan 16 §4.2, §9): a curated list, so the one `@import` the
+ * emitter writes only ever names families and weights Google serves — an unknown family or a weight
+ * a family lacks makes Google answer 400, and every font of the design would be missing. The
+ * render-worker's asset cache serves the stylesheet and the files like any other Google Fonts request.
+ */
+export interface GoogleFont {
+    family: string;
+    category: 'sans-serif' | 'serif' | 'display' | 'monospace' | 'handwriting';
+    weights: number[];
+    italic: boolean;
+}
+export declare const googleFonts: GoogleFont[];
+export declare function googleFont(family: string): GoogleFont | undefined;
+/** The generic family a font falls back to in CSS. */
+export declare function genericFamily(font: GoogleFont | undefined): string;
+/** The weight a family serves that is closest to the one asked for (heavier on a tie). */
+export declare function nearestWeight(font: GoogleFont, weight: number): number;
+/**
+ * One stylesheet URL for every family, weight and style a design uses, or null when it uses none.
+ * `display=block`, so a capture never shows a fallback font.
+ */
+export declare function googleFontsUrl(uses: Array<{
+    family: string;
+    weight: number;
+    italic: boolean;
+}>): string | null;

package/types/lib/design/hash.d.cts

@@ -0,0 +1,6 @@
+/**
+ * The hash a design keeps of the body and CSS the emitter wrote (plan 16 §4.5): equal means the design
+ * still owns the code, different means someone edited it. It detects edits and defends nothing, so a
+ * fast non-cryptographic hash does: two FNV-1a passes with different offsets, 64 bits as hex.
+ */
+export declare function designOutputHash(html: string, css: string): string;

package/types/lib/design/hash.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The hash a design keeps of the body and CSS the emitter wrote (plan 16 §4.5): equal means the design
+ * still owns the code, different means someone edited it. It detects edits and defends nothing, so a
+ * fast non-cryptographic hash does: two FNV-1a passes with different offsets, 64 bits as hex.
+ */
+export declare function designOutputHash(html: string, css: string): string;

package/types/lib/design/index.d.cts

@@ -0,0 +1,12 @@
+/**
+ * `@formfeed/engine/design`: visual designs without the template engines (plan 16 §4), for hosts that
+ * read or write designs but never render — the MCP server, the gateway's checks, tools. Free of
+ * Nunjucks, LiquidJS, Handlebars, bwip-js and date-fns; the main entry exports the same.
+ */
+export * from './types.cjs';
+export { DESIGN_LIMITS, dataPathPattern, designBytes, layerIdPattern, parseDesign, type ParsedDesign, } from './parse.cjs';
+export { emitDesign, type EmittedDesign } from './emit.cjs';
+export { designOutputHash } from './hash.cjs';
+export { genericFamily, googleFont, googleFonts, googleFontsUrl, nearestWeight, type GoogleFont, } from './fonts.cjs';
+export { defaultLayer, emptyDesign, imageIsEmpty, nextLayerId } from './layers.cjs';
+export { designStarters, type DesignStarter } from './starters.cjs';

package/types/lib/design/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `@formfeed/engine/design`: visual designs without the template engines (plan 16 §4), for hosts that
+ * read or write designs but never render — the MCP server, the gateway's checks, tools. Free of
+ * Nunjucks, LiquidJS, Handlebars, bwip-js and date-fns; the main entry exports the same.
+ */
+export * from './types.js';
+export { DESIGN_LIMITS, dataPathPattern, designBytes, layerIdPattern, parseDesign, type ParsedDesign, } from './parse.js';
+export { emitDesign, type EmittedDesign } from './emit.js';
+export { designOutputHash } from './hash.js';
+export { genericFamily, googleFont, googleFonts, googleFontsUrl, nearestWeight, type GoogleFont, } from './fonts.js';
+export { defaultLayer, emptyDesign, imageIsEmpty, nextLayerId } from './layers.js';
+export { designStarters, type DesignStarter } from './starters.js';

package/types/lib/design/layers.d.cts

@@ -0,0 +1,12 @@
+import { type CanvasSize, type DesignDocument, type DesignLayer, type ImageSource, type LayerType } from './types.cjs';
+/**
+ * An image layer whose image is not chosen yet: an empty file name, URL or data path. A new layer
+ * starts that way; the emitter writes an empty box for it and the editor asks for an image.
+ */
+export declare function imageIsEmpty(source: ImageSource): boolean;
+/** A design with nothing on it but a white canvas. */
+export declare function emptyDesign(): DesignDocument;
+/** The next free id for a layer of `type`: `text-1`, `text-2`, … */
+export declare function nextLayerId(design: DesignDocument, type: LayerType): string;
+/** A new layer of `type` in the middle of the canvas, sized for it. */
+export declare function defaultLayer(type: LayerType, id: string, name: string, canvas: CanvasSize): DesignLayer;

package/types/lib/design/layers.d.ts

@@ -0,0 +1,12 @@
+import { type CanvasSize, type DesignDocument, type DesignLayer, type ImageSource, type LayerType } from './types.js';
+/**
+ * An image layer whose image is not chosen yet: an empty file name, URL or data path. A new layer
+ * starts that way; the emitter writes an empty box for it and the editor asks for an image.
+ */
+export declare function imageIsEmpty(source: ImageSource): boolean;
+/** A design with nothing on it but a white canvas. */
+export declare function emptyDesign(): DesignDocument;
+/** The next free id for a layer of `type`: `text-1`, `text-2`, … */
+export declare function nextLayerId(design: DesignDocument, type: LayerType): string;
+/** A new layer of `type` in the middle of the canvas, sized for it. */
+export declare function defaultLayer(type: LayerType, id: string, name: string, canvas: CanvasSize): DesignLayer;

package/types/lib/design/parse.d.cts

@@ -0,0 +1,25 @@
+import { type DesignDocument } from './types.cjs';
+/**
+ * Reads a design as it arrives from `settings.design`: from the editor, but also from the API or a
+ * pushed `design.json`, so nothing is trusted. Every value is checked, numbers are clamped to sane
+ * ranges, and a problem names where it is; a design with problems is not half loaded (the editor opens
+ * the template as code and says so).
+ */
+export declare const DESIGN_LIMITS: {
+    readonly layers: 200;
+    readonly textPerLayer: 5000;
+    readonly bytes: number;
+};
+export type ParsedDesign = {
+    design: DesignDocument;
+    problems: [];
+} | {
+    design: null;
+    problems: string[];
+};
+export declare const layerIdPattern: RegExp;
+/** A data path the emitter writes as is in every engine: dotted identifiers. */
+export declare const dataPathPattern: RegExp;
+/** A design's size as the gateway bounds it: the UTF-8 bytes of its JSON. */
+export declare function designBytes(value: unknown): number;
+export declare function parseDesign(value: unknown): ParsedDesign;

package/types/lib/design/parse.d.ts

@@ -0,0 +1,25 @@
+import { type DesignDocument } from './types.js';
+/**
+ * Reads a design as it arrives from `settings.design`: from the editor, but also from the API or a
+ * pushed `design.json`, so nothing is trusted. Every value is checked, numbers are clamped to sane
+ * ranges, and a problem names where it is; a design with problems is not half loaded (the editor opens
+ * the template as code and says so).
+ */
+export declare const DESIGN_LIMITS: {
+    readonly layers: 200;
+    readonly textPerLayer: 5000;
+    readonly bytes: number;
+};
+export type ParsedDesign = {
+    design: DesignDocument;
+    problems: [];
+} | {
+    design: null;
+    problems: string[];
+};
+export declare const layerIdPattern: RegExp;
+/** A data path the emitter writes as is in every engine: dotted identifiers. */
+export declare const dataPathPattern: RegExp;
+/** A design's size as the gateway bounds it: the UTF-8 bytes of its JSON. */
+export declare function designBytes(value: unknown): number;
+export declare function parseDesign(value: unknown): ParsedDesign;