postext 1.46.4 → 1.48.0

package/dist/composed/modules.d.ts

@@ -0,0 +1,30 @@
+import type { ComposedModuleUse, ResolvedFrameGroup, ResolvedModule, ResolvedPageTemplate } from './types';
+/** The name of a module's frame, group or element `local` in instance
+ *  `instance`. */
+export declare function moduleScoped(instance: string, local: string): string;
+/**
+ * `page` with the modules `uses` laid in its modules group (see the
+ * module comment). `moduleOf` resolves a module template by id. A use
+ * whose template is unknown or no module, or whose name an earlier use
+ * took, is left out (the slot checks report it); a page with no modules
+ * group, or no use left, comes back as it is.
+ */
+export declare function expandModules(page: ResolvedPageTemplate, uses: readonly ComposedModuleUse[], moduleOf: (id: string) => ResolvedPageTemplate | undefined): ResolvedPageTemplate;
+/** The module a frame of an expanded template belongs to (#1062), with its
+ *  modules group and its place among the group's modules (1-based). */
+export declare function moduleOfFrame(template: Pick<ResolvedPageTemplate, 'groups' | 'modules'>, name: string): {
+    module: ResolvedModule;
+    group: ResolvedFrameGroup;
+    item: number;
+    frames: string[];
+} | undefined;
+/** The modules a page of `template` lays, as uses (`VDTComposedPage.modules`). */
+export declare function moduleUses(template: Pick<ResolvedPageTemplate, 'modules'>): ComposedModuleUse[] | undefined;
+/** `list` as the uses `resolvePageTemplate` takes (#1062): each name once,
+ *  in order, a nested module left out. Undefined when none is left. */
+export declare function moduleUsesOf(list: readonly {
+    name: string;
+    template: string;
+    nested?: true;
+}[] | undefined): ComposedModuleUse[] | undefined;
+//# sourceMappingURL=modules.d.ts.map

package/dist/composed/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../src/composed/modules.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAK1H;kBACkB;AAClB,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpE;AA6CD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,SAAS,iBAAiB,EAAE,EAClC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,oBAAoB,GAAG,SAAS,GACzD,oBAAoB,CAoFtB;AAED;uEACuE;AACvE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAUzM;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,GAAG,iBAAiB,EAAE,GAAG,SAAS,CAE3G;AAED;uEACuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,IAAI,CAAA;CAAE,EAAE,GAAG,SAAS,GAAG,iBAAiB,EAAE,GAAG,SAAS,CAU5I"}

package/dist/composed/modules.js

@@ -0,0 +1,194 @@
+/** The `role` of a module template. */
+const MODULE = 'module';
+/** The name of a module's frame, group or element `local` in instance
+ *  `instance`. */
+export function moduleScoped(instance, local) {
+    return `${instance}.${local}`;
+}
+/** `placement` with its references (`anchor.to`, a size's `to`) to `'#x'`
+ *  read through `rename`, and its `'container'` anchor read as `container`
+ *  when given. */
+function rewritePlacement(placement, rename, container) {
+    if (!placement)
+        return placement;
+    const ref = (to) => {
+        if (typeof to !== 'string')
+            return to;
+        if (to === 'container' && container !== undefined)
+            return `#${container}`;
+        if (!to.startsWith('#'))
+            return to;
+        const renamed = rename(to.slice(1));
+        return renamed !== undefined ? `#${renamed}` : to;
+    };
+    const anchor = placement.anchor ? { ...placement.anchor, to: ref(placement.anchor.to ?? 'container') } : placement.anchor;
+    let size = placement.size;
+    if (size) {
+        const out = { ...size };
+        for (const key of ['width', 'height', 'maxWidth']) {
+            const v = size[key];
+            if (v !== null && typeof v === 'object' && 'to' in v)
+                out[key] = { ...v, to: ref(v.to) };
+        }
+        size = out;
+    }
+    return { ...placement, anchor, ...(size ? { size } : {}) };
+}
+/** A connector's ends (#1056) read through `rename`: `'#x'`, an instance
+ *  `'#x[2]'` and every instance `'#x[*]'` of a frame of the module name its
+ *  scoped frame; ends on frames outside the module are kept as written. */
+function rewriteConnectorEnds(connector, rename) {
+    const end = (e) => {
+        if (typeof e?.to !== 'string' || !e.to.startsWith('#'))
+            return e;
+        const ref = e.to.slice(1);
+        const bracket = ref.indexOf('[');
+        const base = bracket >= 0 ? ref.slice(0, bracket) : ref;
+        const renamed = rename(base);
+        return renamed === undefined ? e : { ...e, to: `#${renamed}${bracket >= 0 ? ref.slice(bracket) : ''}` };
+    };
+    return { from: end(connector.from), to: Array.isArray(connector.to) ? connector.to.map(end) : end(connector.to) };
+}
+/**
+ * `page` with the modules `uses` laid in its modules group (see the
+ * module comment). `moduleOf` resolves a module template by id. A use
+ * whose template is unknown or no module, or whose name an earlier use
+ * took, is left out (the slot checks report it); a page with no modules
+ * group, or no use left, comes back as it is.
+ */
+export function expandModules(page, uses, moduleOf) {
+    const group = page.groups.find((g) => g.modules);
+    if (!group || uses.length === 0)
+        return page;
+    const taken = new Set();
+    const frames = [];
+    const groups = [];
+    const elements = [];
+    const paths = [];
+    const modules = [];
+    for (const use of uses) {
+        const m = moduleOf(use.template);
+        if (!m || m.role !== MODULE || taken.has(use.name))
+            continue;
+        taken.add(use.name);
+        const local = new Set([...m.frames.map((f) => f.name), ...m.groups.map((g) => g.name)]);
+        for (const e of m.decoration.elements)
+            if (typeof e.id === 'string')
+                local.add(e.id);
+        const scope = (n) => moduleScoped(use.name, n);
+        const rename = (n) => (local.has(n) ? scope(n) : undefined);
+        const own = m.frames.map((f) => {
+            const out = { ...f, name: scope(f.name), placement: rewritePlacement(f.placement, rename), flow: false };
+            if (out.placement === undefined)
+                delete out.placement;
+            // A module has no grid of its own: a cell reads as no placement.
+            delete out.grid;
+            // A module's `takes` frame takes from its own `:::module` (wrap).
+            delete out.takes;
+            if (f.next !== undefined) {
+                if (local.has(f.next))
+                    out.next = scope(f.next);
+                else
+                    delete out.next;
+            }
+            const to = f.overflow.continueIn;
+            if (typeof to === 'string' && to.startsWith('#')) {
+                out.overflow = { ...f.overflow };
+                if (local.has(to.slice(1)))
+                    out.overflow.continueIn = `#${scope(to.slice(1))}`;
+                else
+                    delete out.overflow.continueIn;
+            }
+            return out;
+        });
+        const ownGroups = m.groups.map((g) => {
+            const out = { ...g, name: scope(g.name), frames: g.frames.map(scope) };
+            if (g.repeat)
+                out.repeat = { ...g.repeat, frames: g.repeat.frames.map(scope) };
+            const placement = rewritePlacement(g.placement, rename);
+            if (placement)
+                out.placement = placement;
+            delete out.grid;
+            return out;
+        });
+        const ownElements = m.decoration.elements.map((e) => {
+            const id = typeof e.id === 'string' ? { id: scope(e.id) } : {};
+            if (e.kind === 'connector')
+                return { ...e, ...id, ...rewriteConnectorEnds(e, rename) };
+            return { ...e, ...id, placement: rewritePlacement(e.placement, rename, use.name) };
+        });
+        const flow = m.frames.find((f) => f.flow);
+        const takes = {};
+        for (const f of m.frames)
+            if (f.takes && takes[f.takes] === undefined)
+                takes[f.takes] = scope(f.name);
+        frames.push(...own);
+        groups.push(...ownGroups);
+        elements.push(...ownElements);
+        paths.push(...m.decorationPaths);
+        modules.push({
+            name: use.name,
+            template: use.template,
+            group: group.name,
+            configPath: m.configPath,
+            frames: own.map((f) => f.name),
+            groups: ownGroups.map((g) => g.name),
+            elements: ownElements.flatMap((e) => (typeof e.id === 'string' ? [e.id] : [])),
+            ...(flow ? { flow: scope(flow.name) } : {}),
+            ...(Object.keys(takes).length > 0 ? { takes } : {}),
+        });
+    }
+    if (modules.length === 0)
+        return page;
+    const modulesGroup = {
+        ...group,
+        frames: frames.map((f) => f.name),
+        items: modules.map((m, k) => ({ item: k + 1, frames: [...m.frames], module: m.name })),
+    };
+    return {
+        ...page,
+        frames: [...page.frames, ...frames],
+        // The modules group first among the groups that hold a module frame:
+        // the page lays it as one step.
+        groups: [...page.groups.map((g) => (g === group ? modulesGroup : g)), ...groups],
+        decoration: { ...page.decoration, elements: [...page.decoration.elements, ...elements] },
+        decorationPaths: [...page.decorationPaths, ...paths],
+        modules,
+    };
+}
+/** The module a frame of an expanded template belongs to (#1062), with its
+ *  modules group and its place among the group's modules (1-based). */
+export function moduleOfFrame(template, name) {
+    if (!template.modules || template.modules.length === 0)
+        return undefined;
+    for (const group of template.groups) {
+        if (!group.modules || !group.items)
+            continue;
+        // (The group's items name a grid's instances once they are laid out.)
+        const item = group.items.find((c) => c.frames.includes(name));
+        const m = item ? template.modules.find((x) => x.name === item.module) : undefined;
+        if (item && m)
+            return { module: m, group, item: item.item, frames: item.frames };
+    }
+    return undefined;
+}
+/** The modules a page of `template` lays, as uses (`VDTComposedPage.modules`). */
+export function moduleUses(template) {
+    return template.modules && template.modules.length > 0 ? template.modules.map((m) => ({ name: m.name, template: m.template })) : undefined;
+}
+/** `list` as the uses `resolvePageTemplate` takes (#1062): each name once,
+ *  in order, a nested module left out. Undefined when none is left. */
+export function moduleUsesOf(list) {
+    if (!list || list.length === 0)
+        return undefined;
+    const seen = new Set();
+    const out = [];
+    for (const m of list) {
+        if (m.nested || m.name === '' || seen.has(m.name))
+            continue;
+        seen.add(m.name);
+        out.push({ name: m.name, template: m.template });
+    }
+    return out.length > 0 ? out : undefined;
+}
+//# sourceMappingURL=modules.js.map

package/dist/composed/modules.js.map

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

package/dist/composed/overlap.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The overlap checks of a composed page (#1053, DESIGN §12.10): what the
+ * reflow ladder never sees, because no frame's content is short of its box.
+ *
+ * - `frameCovered`: ink of a frame (its lines, its tab and title, its
+ *   pictures) under a frame painted after it (a higher `layer`, or the same
+ *   layer later in template order, as `composedPaintOrder` paints them)
+ *   where that frame is opaque: its fill (the boxes of its overlay with a
+ *   background: the style's or `look`'s fill, a label tab, a stripe), its
+ *   pictures and its text. A frame with no fill covers nothing between its
+ *   pictures and lines; words cover words, not pictures (a line over a
+ *   picture hides a hairline of it).
+ * - `frameOutsideArea`: ink of a frame past what holds it: its text past
+ *   the trim (cut there), its fill or pictures past the bleed (a fill may
+ *   bleed on purpose), or any of it past the frame or group it is anchored
+ *   inside (a nine-point anchor on `'#name'` whose point lies in that box).
+ *
+ * Pure: it reads the laid frames and their blocks, so it runs on the
+ * composition the ladder settled on, before a spread is cut at its spine
+ * (the facing copies do not exist yet). Every box is put on the sheet by
+ * its frame's matrix (scale, turn) and compared as the box holding it.
+ */
+import type { ContentWarning, ReflowEvent, VDTBlock, VDTFrame } from '../vdt';
+import { type FrameAreas, type Rect } from './geometry';
+import type { ResolvedPageTemplate } from './types';
+export interface OverlapCheckInput {
+    /** The template laid (with the ladder's patches). */
+    template: ResolvedPageTemplate;
+    /** The page's frames as laid, any order. */
+    frames: readonly VDTFrame[];
+    /** The page's frame blocks (each frame's box first). */
+    blocks: readonly VDTBlock[];
+    /** Groups' final boxes, by name. */
+    groupRects: ReadonlyMap<string, Rect>;
+    areas: FrameAreas;
+    dpi: number;
+    emPx: number;
+    fenceIndex: number;
+    pageIndex: number;
+    locale?: string;
+}
+export interface OverlapCheckResult {
+    warnings: ContentWarning[];
+    /** `covered` and `outside` events of the reflow log. */
+    events: ReflowEvent[];
+}
+/**
+ * The overlap warnings of one composed page (or the sheet of a spread),
+ * and the reflow log's events for them.
+ */
+export declare function overlapChecks(input: OverlapCheckInput): OverlapCheckResult;
+//# sourceMappingURL=overlap.d.ts.map

package/dist/composed/overlap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlap.d.ts","sourceRoot":"","sources":["../../src/composed/overlap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,cAAc,EAA4C,WAAW,EAAE,QAAQ,EAAkB,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAIxI,OAAO,EAAY,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAGlE,OAAO,KAAK,EAAiB,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAyBnE,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,4CAA4C;IAC5C,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,wDAAwD;IACxD,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,oCAAoC;IACpC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,wDAAwD;IACxD,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAkJD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CAoP1E"}