studiograph 1.3.48-next.261 → 1.3.48-next.262

package/dist/core/artifact-columns-css.js

@@ -0,0 +1,157 @@
+/**
+ * Rewrite author CSS so a `pages` document's flowing content paginates under
+ * NATIVE CSS multi-column (the columns compositor) instead of Paged.js.
+ *
+ * WHY: the compositor lays the document body out as one tall multi-column flow
+ * (`column-width` = the page content width); each column == one page. Two author
+ * CSS idioms were written for Paged.js's `@page` model and DON'T translate:
+ *   1. Forced PAGE breaks (`break-before:page`, legacy `page-break-*:always`, …)
+ *      do nothing inside a multicol container — they must become COLUMN breaks.
+ *   2. `position:running(name)` elements (the source for `@page` margin-box
+ *      running headers) are inert outside `@page`; left in the body flow they
+ *      render as stray in-flow content. They must be removed from the flow.
+ *
+ * This is a BUILD-TIME transform (run once on the emitted shared CSS + each
+ * paginated frame's inline `<style>` blocks), so there is no sandboxed-runtime
+ * twin to keep in lock-step — unlike the former Paged.js url() sanitizer.
+ *
+ * PARSER, NOT BARE REGEX: a naive `String.replace` would corrupt a
+ * `content:"break-before:page"` string literal, a `/* break-before:page *​/`
+ * comment, or text inside a `url()`. So we first SEGMENT the CSS — copying
+ * comments, string literals, and `url()` tokens through VERBATIM — and apply the
+ * property/value rewrites ONLY to the "normal" CSS runs between them. The
+ * segmenter mirrors the skip logic of the (removed) `artifact-paged-css.ts` url
+ * scanner: it honors `\` escapes and never matches `url(` inside a comment or
+ * string.
+ *
+ * Scope: `@page` blocks and the `page:` property are left untouched — they are
+ * simply ignored by the screen render (and the PDF export composites the page
+ * tiles, so it never consults the author's `@page`). Named-page break values are
+ * not real `break-before` keywords, so they need no mapping.
+ */
+const IDENT = /[A-Za-z0-9_-]/;
+const SPACE = /\s/;
+/** Apply the break/running rewrites to a run of NORMAL css (no comments, strings,
+ *  or url() tokens — the segmenter guarantees that). Property names + values are
+ *  matched with `\b` boundaries so `break-before:pagex` (a longer value) is never
+ *  partially rewritten. Order matters: the `avoid-page` and legacy `page-break-*`
+ *  rules run before the generic forced-break rule so each declaration maps once. */
+function rewriteColumnsInNormalCss(s) {
+    const lc = (x) => x.toLowerCase();
+    // Each property name is left-anchored with `(?<![\w-])` so it matches a WHOLE
+    // property, never a substring of a longer one — e.g. a custom property
+    // `--page-break-before` or a vendor prefix `-webkit-page-break-before` /
+    // `-webkit-column-break-before` (both preceded by `-`) are left untouched rather
+    // than mangled into an invalid property. Legitimate declarations are preceded by
+    // `{`, `;`, whitespace, a quote, or start-of-string — none of which are `[\w-]`.
+    return s
+        // position:running(header) → display:none (remove the running source from flow).
+        .replace(/(?<![\w-])position\s*:\s*running\([^)]*\)/gi, 'display:none')
+        // break-inside:avoid-page → break-inside:avoid (page-specific avoidance → generic).
+        .replace(/(?<![\w-])break-(inside|before|after)\s*:\s*avoid-page\b/gi, (_m, d) => `break-${lc(d)}:avoid`)
+        // Legacy page-break-* shorthand → modern break-*.
+        .replace(/(?<![\w-])page-break-(before|after)\s*:\s*(?:always|left|right|recto|verso|page)\b/gi, (_m, d) => `break-${lc(d)}:column`)
+        .replace(/(?<![\w-])page-break-(before|after)\s*:\s*avoid\b/gi, (_m, d) => `break-${lc(d)}:avoid`)
+        .replace(/(?<![\w-])page-break-inside\s*:\s*avoid\b/gi, 'break-inside:avoid')
+        // Modern forced PAGE break → forced COLUMN break.
+        .replace(/(?<![\w-])break-(before|after)\s*:\s*(?:page|always|left|right|recto|verso)\b/gi, (_m, d) => `break-${lc(d)}:column`);
+}
+/**
+ * Token-aware rewrite of author CSS for the native-columns compositor. Copies
+ * comments / string literals / `url()` tokens through verbatim; rewrites forced
+ * page breaks → column breaks and neutralizes `position:running()` only in the
+ * normal CSS between them. Idempotent (a second pass finds nothing to change).
+ */
+export function rewriteAuthorCssForColumns(css) {
+    if (!css)
+        return css;
+    const len = css.length;
+    const isIdent = (c) => c !== undefined && IDENT.test(c);
+    const isSpace = (c) => c !== undefined && SPACE.test(c);
+    let out = '';
+    let normal = '';
+    const flush = () => { if (normal) {
+        out += rewriteColumnsInNormalCss(normal);
+        normal = '';
+    } };
+    let i = 0;
+    while (i < len) {
+        const c = css[i];
+        // CSS comment — copy through untouched.
+        if (c === '/' && css[i + 1] === '*') {
+            flush();
+            const end = css.indexOf('*/', i + 2);
+            const stop = end === -1 ? len : end + 2;
+            out += css.slice(i, stop);
+            i = stop;
+            continue;
+        }
+        // String literal — copy through (a break/running token inside a string is data).
+        if (c === '"' || c === "'") {
+            flush();
+            let j = i + 1;
+            while (j < len) {
+                if (css[j] === '\\') {
+                    j += 2;
+                    continue;
+                }
+                if (css[j] === c) {
+                    j++;
+                    break;
+                }
+                j++;
+            }
+            out += css.slice(i, j);
+            i = j;
+            continue;
+        }
+        // url( … ) token — copy through verbatim (only when `url` is a standalone
+        // function name, so `myurl(` / `figurl(` are normal text).
+        if ((c === 'u' || c === 'U') && css.slice(i, i + 4).toLowerCase() === 'url(' && !isIdent(css[i - 1])) {
+            flush();
+            let j = i + 4;
+            while (j < len && isSpace(css[j]))
+                j++;
+            if (css[j] === '"' || css[j] === "'") {
+                const q = css[j];
+                j++;
+                while (j < len) {
+                    if (css[j] === '\\') {
+                        j += 2;
+                        continue;
+                    }
+                    if (css[j] === q) {
+                        j++;
+                        break;
+                    }
+                    j++;
+                }
+                while (j < len && isSpace(css[j]))
+                    j++;
+                if (css[j] === ')')
+                    j++;
+            }
+            else {
+                while (j < len) {
+                    if (css[j] === '\\') {
+                        j += 2;
+                        continue;
+                    }
+                    if (css[j] === ')') {
+                        j++;
+                        break;
+                    }
+                    j++;
+                }
+            }
+            out += css.slice(i, j);
+            i = j;
+            continue;
+        }
+        normal += c;
+        i++;
+    }
+    flush();
+    return out;
+}
+//# sourceMappingURL=artifact-columns-css.js.map

package/dist/core/artifact-columns-css.js.map

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

package/dist/core/artifact-frame-document.d.ts

@@ -38,12 +38,6 @@ export interface FrameDocumentContext {
     /** Base URL for a headless render so root-relative `/api/assets/...` resolve.
      *  Never set on a downloaded file (it must not phone home). */
     baseHref?: string;
-    /** Paged.js source (the `Paged` UMD global). Supplied by the host loader when
-     *  the bundle has any paginated `document` frame; absent otherwise. Injected
-     *  in-sandbox so the platform fragments a document's flowing content stream
-     *  into page boxes (P3.3). Pure @core can't read it from disk, so it threads
-     *  in like `librarySources`. */
-    pagedSource?: string;
     /** Opaque per-render id echoed back in the runtime's `frame-pages` message so
      *  the host can drop a stale pagination result from a superseded render (the
      *  double-buffer slot may be reset/reloaded with newer content before a slow
@@ -81,25 +75,73 @@ export declare function isPagesArtifact(bundle: ArtifactBundle): boolean;
  *  present (no stepper). The host (FrameCanvas) imports this so its whiteboard
  *  predicate can't drift from the renderer. */
 export declare function isWhiteboard(bundle: ArtifactBundle): boolean;
-/** Whether a HOST-LESS render (PNG/PDF/inspect/standalone download) should carry
- *  the Paged.js source to fragment this bundle into a page column. THE single
+/** Rewrite a paginated frame's CSS for the native-columns compositor (forced page
+ *  breaks → column breaks; `position:running()` removed), covering BOTH `<style>`
+ *  blocks AND inline `style="…"` / `style='…'` attributes. An element with an inline
+ *  `style="break-before:page"` (the offer-letter signature-block idiom) would
+ *  otherwise survive un-mapped and only paginate by Chromium's lenient page→column
+ *  coercion inside multicol — not guaranteed cross-browser. Each value runs through
+ *  the same token-safe {@link rewriteAuthorCssForColumns}.
+ *
+ *  ONE left-to-right scan over an alternation whose `<style>`-block branch is FIRST,
+ *  so the scanner consumes a whole style element before it can reach a `style=`
+ *  literal sitting in that element's CSS text (an `[style]` attribute selector, a
+ *  `content:"…style=…"` string): only real markup attributes match the inline branch
+ *  — no double-processing. A style element's text can't contain `</style>`, so the
+ *  non-greedy block match is safe. (Limitation, mirroring the url() segmenter's: body
+ *  TEXT shaped exactly like `style="break-before:page"` would also be rewritten; that
+ *  pathological case is not worth a full HTML parser, and the value itself is still
+ *  token-safe — strings/url()/comments inside it are preserved. Only QUOTED
+ *  attribute values are matched; a rare unquoted single-declaration
+ *  `style=break-before:page` is left to the browser's lenient page→column coercion,
+ *  as it was before this mapping existed.) */
+export declare function rewritePaginatedContentStyles(html: string): string;
+/** Whether a HOST-LESS render (PNG/PDF/inspect/standalone download) lays this
+ *  bundle out as a scrolling page COLUMN of compositor-built page tiles. THE single
  *  source of truth for that decision across every host-less caller (the headless
  *  render, the export route, the MCP export tool), so none drifts from the
  *  builder's actual column layout.
  *
  *  Requires a FULLY-paginated document — every frame is a `pages` frame — with at
  *  least one fixed page box. A MIXED artifact (pages + other layouts) is NOT
- *  paginated host-less: the column layout ({@link isPagesArtifact}) wouldn't
- *  apply, so it would fall to the clipped grid AND the render's page-box selector
- *  would switch to `.pagedjs_page` and drop the non-page frames entirely. Instead
- *  a mixed artifact renders as the grid with every frame present (the live editor,
- *  which PROMOTES pages into the grid, is the surface that paginates mixed). This
- *  also drops the `.some(layout === 'pages')` variants that shipped ~500KB of
- *  Paged.js for an auto/fill `pages` frame the builder never paginates. */
+ *  paginated host-less: the column layout ({@link isPagesArtifact}) wouldn't apply,
+ *  so it would fall to the clipped grid AND the render's page-box selector would
+ *  switch to the page TILES and drop the non-page frames entirely. Instead a mixed
+ *  artifact renders as the grid with every frame present (the live editor, which
+ *  composites pages into the grid, is the surface that paginates mixed). The
+ *  compositor itself is always inlined (no library to load), so this no longer
+ *  gates a multi-hundred-KB Paged.js fetch — only the host-less COLUMN vs GRID
+ *  layout choice + the page-box selector. */
 export declare function bundleNeedsPagination(bundle: ArtifactBundle): boolean;
+interface ResolvedPageMargins {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/** The native-columns geometry for one paginated `pages` frame: the page box
+ *  (`width`×`height`), the content area inside the margins (`contentWidth`×
+ *  `contentHeight`), the inter-page gutter in the measurement/clip flow (`gap` =
+ *  both side margins + a 40px buffer so adjacent pages never visually touch), and
+ *  the column `pitch` (`contentWidth + gap`). The compositor lays the document
+ *  body out as one tall multi-column flow of `contentWidth`-wide columns; each
+ *  column is one page, and translating the flow by `−i*pitch` reveals page `i` in
+ *  a clipped window. PURE + exported so the arithmetic is unit-testable (the
+ *  in-browser two-pass measure on top of it can only be covered by e2e). */
+export interface ColumnPageGeometry {
+    width: number;
+    height: number;
+    contentWidth: number;
+    contentHeight: number;
+    gap: number;
+    pitch: number;
+    margins: ResolvedPageMargins;
+}
+export declare function columnPageGeometry(frame: ArtifactBundle['frames'][number]): ColumnPageGeometry;
 /**
  * Build the single sandboxed-iframe document for a frame-model bundle. Every
  * surface calls this; `host` selects whether a live host drives chrome/transform
  * (`iframe`) or the file is self-contained (`none`).
  */
 export declare function buildFrameDocument(bundle: ArtifactBundle, ctx: FrameDocumentContext): string;
+export {};