studiograph 1.3.48-next.262 → 1.3.48-next.264

package/dist/agent/skills/paged-documents/skill.md

@@ -27,8 +27,9 @@ ONE <pages> frame  ──native columns──▶  page 1 │ page 2 │ page 3
 
 - **Page SIZE is the frame `geometry` — ANY width × height, portrait, landscape, or arbitrary.** Common print presets (portrait; swap width↔height for landscape): US-Letter `816×1056`, Legal `816×1344`, Tabloid `1056×1632`, A4 `794×1123`, A3 `1123×1587`, A5 `559×794`. A custom size is equally valid (a landscape report `1056×816`, a square `1000×1000`). Pick the geometry the document calls for. Do NOT write `@page { size }` — it is ignored; geometry is the size.
 - **`pageMargins`** (a `pages` frame field, px per side; absent sides default to top 96 / sides 72 / bottom 84) sets the page margins. The content area is `width − left − right` by `height − top − bottom`. Scale margins to the page size, and make the top/bottom big enough for the furniture (a tall letterhead needs a taller top margin — furniture is out-of-flow and can't reserve its own space).
-- **A default "Page N of M"** is drawn bottom-right on every page. A `furniture.footer` you supply sits to its left, clear of it.
+- **Page numbers** default to "Page N of M" bottom-right on every page, **in the document's own body type**; the **`pageNumbers`** frame field controls them — hide them (`{ "show": false }`), restyle the text (`"format": "{n}"` for a bare numeral; `{n}` = page, `{m}` = last page), move to any corner/edge (`"position": "top-center"`), skip the cover (`"showOnFirst": false`) or a trailing page such as a contact/colophon page (`"showOnLast": false`), pin near the page edge (`"offset"`), or override the numeral type (`"fontFamily"` / `"fontWeight"` / `"fontSize"` px / `"color"`). **The numeral inherits the document body's font / size / weight / color by default** — set those fields only to make it differ (e.g. a lighter, smaller running number); for a numeral that simply matches the body, set nothing. A `furniture.footer` clears the *default* bottom-right counter automatically; if you MOVE the number (e.g. `bottom-left`, `top-center`), make sure it doesn't collide with furniture in that same corner — clearance is only automatic for the default position.
 - **ONE uniform page geometry per document.** Every page shares the same `geometry` + `pageMargins`. Per-section page margins (a different top margin for an appendix vs the cover) are NOT expressible under native columns — pick one geometry that works for the whole document. This is the one real constraint vs the old `@page`-per-section model.
+- **The page-box model (know this — it explains margin behavior).** `pageMargins.top` reserves a band the **body cannot write into** (body starts at the content edge; content pushed above it is clipped, not drawn into the margin). Furniture by default anchors at that content edge, so with a deep top margin a header sits LOW (just above the body). To put a masthead HIGH while keeping a deep body margin, anchor the furniture to the page edge (`furniture.header.anchor: "page"`, below).
 - **Fixed height is required to paginate.** A `pages` frame with a fixed height (e.g. `1056`) flows overflow onto more pages. `height: "auto"` does NOT paginate — it renders as one tall continuous page. Use `auto` only for a deliberately single, non-paginated scroll.
 - **Cross-browser.** On-screen page breaks are computed by the *viewing* browser's native fragmentation, so a Safari/Firefox user may see breaks fall a line differently than Chrome. The exported PDF (always Chromium) is the **canonical** pagination. Content is correct everywhere; don't hand-tune to one browser's break positions.
 
@@ -48,8 +49,57 @@ ONE <pages> frame  ──native columns──▶  page 1 │ page 2 │ page 3
 
 - Put **real designed HTML** in furniture (a logo lockup, an address block, a rule) — aim for a designed letterhead, not a plain text line. Lay multi-part headers out with flex or absolute positioning inside the furniture HTML; it is normal in-margin HTML (no Paged.js clone caveats).
 - Use **`first`** to vary page 1 (e.g. a fuller masthead on page 1, a slim running header on the rest) and **`last`** for a closing line.
+- **`anchor` + `offset` per region** place it in the margin band: `"anchor": "content"` (default) hugs the body edge (a running header just above the text); `"anchor": "page"` pins it to the page's outer edge, `"offset"` px in. Use `header.anchor: "page"` for a **letterhead masthead that rides high** even with a deep `pageMargins.top` — the body keeps the deep margin while the masthead sits at the top edge. Put a final-page contact block in `header.last` with `anchor: "page"` to ride high on the last page only.
+- **Per-page variation is first-class:** `first`/`middle`/`last` slots for different furniture per page, a `first`-only header for a masthead on page 1 only, and `pageNumbers.showOnFirst: false` / `showOnLast: false` to drop the number on a cover or a trailing page.
 - **Full-bleed edge-to-edge bands are not supported in v1** — furniture insets to the content column. Keep letterhead within the margins.
-- A cover page that should carry NO running header: there is no per-page suppression in v1 — either keep a slim header throughout, or build a cover as a separate `artboard` frame and the body as a second `pages` frame.
+
+### Letterhead the clean way (masthead high, body low, bare numeral up top)
+
+A classic letter: deep top margin for the body, masthead riding high on page 1, a bare numeral top-center on pages 2+, contact block high on the last page.
+
+```jsonc
+"pageMargins": { "top": 192, "right": 96, "bottom": 96, "left": 96 },   // ~2in body margin
+"furniture": {
+  "header": {
+    "first": "<div class=\"mast\">…masthead…</div>",       // page 1 only
+    "last":  "<div class=\"contact\">…contact block…</div>", // last page only (top-left)
+    "anchor": "page", "offset": 28                          // both ride high at the top edge
+  }
+},
+"pageNumbers": { "position": "top-center", "format": "{n}", "showOnFirst": false, "showOnLast": false, "offset": 28 }
+```
+
+The body sits at the deep 2in margin on every page (uniform geometry, unchanged); the masthead/contact ride at the page edge via `anchor: "page"`; the numeral is a bare `{n}` top-center in the body type, skipped on both the cover and the contact-block last page (`showOnFirst`/`showOnLast: false`).
+
+### Running headers that change by section (e.g. "Exhibit A" / "Exhibit B")
+
+When the running header (or footer) text must change partway through — a contract whose interior is "Agreement Title" but whose exhibits read "Exhibit A", "Exhibit B" — use **per-section variants**. The header content stays in `furniture` (alongside `first`/`middle`/`last`); the BODY marks where each section begins.
+
+- Add a **`sections`** map to the region: `{ "<name>": "<header HTML>" }`. Give each section the same markup/classes as `middle` so it renders consistently.
+- In the body, mark the **start** of each section with `data-sg-section="<name>"` — put it on the element that begins the section (typically the one carrying `break-before: column`, so the section starts on a fresh page). From the page that element lands on, the region renders `sections[name]` instead of `middle`, until the next marker.
+- An **empty** marker — `data-sg-section=""` — *clears* the region (no header/footer) from that page onward. Use it for a back cover with no running header.
+- `first` (page 1) and `last` (final page) still win on their own pages — so to blank the final page with a clear marker, leave `last` unset. A marker name with no matching `sections` entry falls back to `middle` (a typo never blanks the header).
+
+```jsonc
+"furniture": {
+  "header": {
+    "first":  "<div class=\"mast\">…masthead…</div>",          // page 1
+    "middle": "<div class=\"rh\">Proprietary Information and Inventions Agreement</div>",
+    "sections": {
+      "exhibit-a": "<div class=\"rh\">Exhibit A</div>",
+      "exhibit-b": "<div class=\"rh\">Exhibit B</div>"
+    }
+  }
+}
+```
+```html
+<!-- body: mark each section's first element -->
+<h1 style="break-before: column" data-sg-section="exhibit-a">Exhibit A</h1> …
+<h1 style="break-before: column" data-sg-section="exhibit-b">Exhibit B</h1> …
+<section style="break-before: column" data-sg-section="">Back cover…</section>   <!-- no header from here -->
+```
+
+The interior pages read "Proprietary…Agreement"; the exhibit pages read "Exhibit A" / "Exhibit B"; the back cover has no running header. This is the **only** way to vary running-header text by page range — the body cannot write into the margin band, and a single `middle` covers every interior page.
 
 ## Break control (the craft that separates clean from sloppy)
 

package/dist/core/artifact-bundle.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Shared contract for agent-produced canvas artifacts.
+ *
+ * V1 is deliberately text-only: HTML, CSS, JS, SVG, JSON, and plain text files.
+ * Binary assets and network-dependent files are follow-up work, because this
+ * bundle is persisted in chat message metadata and rendered in a sandboxed
+ * iframe.
+ */
+export declare const ARTIFACT_BUNDLE_SCHEMA_VERSION = 1;
+export declare const ARTIFACT_BUNDLE_MAX_BYTES: number;
+export declare const ARTIFACT_KINDS: readonly ["html", "document", "slides", "social", "app", "custom"];
+export type ArtifactKind = typeof ARTIFACT_KINDS[number];
+export declare const ARTIFACT_VIEWPORT_MODES: readonly ["fixed", "responsive", "paged"];
+export type ArtifactViewportMode = typeof ARTIFACT_VIEWPORT_MODES[number];
+export declare const ARTIFACT_FULLSCREEN_FITS: readonly ["contain", "width", "none"];
+export type ArtifactFullscreenFit = typeof ARTIFACT_FULLSCREEN_FITS[number];
+export declare const ARTIFACT_DISPLAY_BACKGROUNDS: readonly ["neutral", "transparent"];
+export type ArtifactDisplayBackground = typeof ARTIFACT_DISPLAY_BACKGROUNDS[number];
+export declare const ARTIFACT_LIBRARY_KEYS: readonly ["three", "d3", "motion"];
+export type ArtifactLibraryKey = typeof ARTIFACT_LIBRARY_KEYS[number];
+export interface ArtifactDisplayViewport {
+    width: number;
+    height: number;
+}
+export interface ArtifactDisplayStepperControl {
+    selector?: string;
+    label?: string;
+}
+export interface ArtifactDisplayControls {
+    stepper?: ArtifactDisplayStepperControl;
+    reset?: boolean;
+}
+export interface ArtifactViewport {
+    width: number;
+    height: number;
+    mode: ArtifactViewportMode;
+}
+export interface ArtifactDisplay {
+    fullscreenFit?: ArtifactFullscreenFit;
+    background?: ArtifactDisplayBackground;
+    fullscreenViewport?: ArtifactDisplayViewport;
+    controls?: ArtifactDisplayControls;
+}
+export interface ArtifactSource {
+    repo?: string;
+    entityType?: string;
+    entityId?: string;
+    skillId?: string;
+}
+export interface ArtifactBundle {
+    schemaVersion: typeof ARTIFACT_BUNDLE_SCHEMA_VERSION;
+    artifactId: string;
+    title: string;
+    kind: ArtifactKind;
+    viewport: ArtifactViewport;
+    display?: ArtifactDisplay;
+    libraries?: ArtifactLibraryKey[];
+    files: Record<string, string>;
+    entrypoint: string;
+    source?: ArtifactSource;
+}
+export interface ArtifactValidationResult {
+    ok: boolean;
+    bundle?: ArtifactBundle;
+    errors: string[];
+    byteSize: number;
+}
+export declare function validateArtifactBundle(input: unknown): ArtifactValidationResult;
+export declare function assertArtifactBundle(input: unknown): ArtifactBundle;

package/dist/core/artifact-bundle.js

@@ -0,0 +1,305 @@
+/**
+ * Shared contract for agent-produced canvas artifacts.
+ *
+ * V1 is deliberately text-only: HTML, CSS, JS, SVG, JSON, and plain text files.
+ * Binary assets and network-dependent files are follow-up work, because this
+ * bundle is persisted in chat message metadata and rendered in a sandboxed
+ * iframe.
+ */
+export const ARTIFACT_BUNDLE_SCHEMA_VERSION = 1;
+export const ARTIFACT_BUNDLE_MAX_BYTES = 512 * 1024;
+export const ARTIFACT_KINDS = ['html', 'document', 'slides', 'social', 'app', 'custom'];
+export const ARTIFACT_VIEWPORT_MODES = ['fixed', 'responsive', 'paged'];
+export const ARTIFACT_FULLSCREEN_FITS = ['contain', 'width', 'none'];
+export const ARTIFACT_DISPLAY_BACKGROUNDS = ['neutral', 'transparent'];
+export const ARTIFACT_LIBRARY_KEYS = ['three', 'd3', 'motion'];
+const TEXT_EXTENSIONS = new Set([
+    '.html', '.htm', '.css', '.js', '.mjs', '.svg', '.json', '.txt', '.md',
+]);
+const ID_RE = /^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,127}$/;
+const PATH_RE = /^[a-zA-Z0-9][a-zA-Z0-9._/-]{0,255}$/;
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function byteLength(value) {
+    return new TextEncoder().encode(JSON.stringify(value)).length;
+}
+function extensionOf(path) {
+    const dot = path.lastIndexOf('.');
+    return dot === -1 ? '' : path.slice(dot).toLowerCase();
+}
+function isSafePath(path) {
+    if (!PATH_RE.test(path))
+        return false;
+    if (path.includes('..'))
+        return false;
+    if (path.includes('//'))
+        return false;
+    if (/^[a-z][a-z0-9+.-]*:/i.test(path))
+        return false;
+    return true;
+}
+function normalizeString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+function inferArtifactLibraries(files) {
+    const text = Object.entries(files)
+        .filter(([path]) => /\.(html?|m?js|css|svg)$/i.test(path))
+        .map(([, content]) => content)
+        .join('\n');
+    const inferred = [];
+    if (/\b(?:window\.)?THREE\b/.test(text) || /\bfrom\s+['"]three(?:\/[^'"]*)?['"]/.test(text)) {
+        inferred.push('three');
+    }
+    if (/\b(?:window\.)?d3\b/.test(text) || /\bfrom\s+['"]d3(?:\/[^'"]*)?['"]/.test(text)) {
+        inferred.push('d3');
+    }
+    if (/\b(?:window\.)?Motion\b/.test(text)
+        || /\bmotion\.(?:animate|spring|inView|scroll)\b/.test(text)
+        || /\bfrom\s+['"]motion(?:\/[^'"]*)?['"]/.test(text)) {
+        inferred.push('motion');
+    }
+    return inferred;
+}
+export function validateArtifactBundle(input) {
+    const errors = [];
+    const byteSize = byteLength(input);
+    if (byteSize > ARTIFACT_BUNDLE_MAX_BYTES) {
+        errors.push(`Artifact bundle exceeds ${ARTIFACT_BUNDLE_MAX_BYTES} bytes`);
+    }
+    if (!isRecord(input)) {
+        return { ok: false, errors: ['Artifact bundle must be an object', ...errors], byteSize };
+    }
+    if (input.schemaVersion !== ARTIFACT_BUNDLE_SCHEMA_VERSION) {
+        errors.push(`schemaVersion must be ${ARTIFACT_BUNDLE_SCHEMA_VERSION}`);
+    }
+    const artifactId = normalizeString(input.artifactId);
+    if (!artifactId || !ID_RE.test(artifactId)) {
+        errors.push('artifactId must be a stable alphanumeric id');
+    }
+    const title = normalizeString(input.title);
+    if (!title)
+        errors.push('title is required');
+    const kind = normalizeString(input.kind);
+    if (!kind || !ARTIFACT_KINDS.includes(kind)) {
+        errors.push(`kind must be one of: ${ARTIFACT_KINDS.join(', ')}`);
+    }
+    const viewport = input.viewport;
+    let normalizedViewport = null;
+    if (!isRecord(viewport)) {
+        errors.push('viewport is required');
+    }
+    else {
+        const width = viewport.width;
+        const height = viewport.height;
+        const mode = viewport.mode;
+        if (typeof width !== 'number' || !Number.isFinite(width) || width < 120 || width > 10000) {
+            errors.push('viewport.width must be between 120 and 10000');
+        }
+        if (typeof height !== 'number' || !Number.isFinite(height) || height < 120 || height > 10000) {
+            errors.push('viewport.height must be between 120 and 10000');
+        }
+        if (typeof mode !== 'string' || !ARTIFACT_VIEWPORT_MODES.includes(mode)) {
+            errors.push(`viewport.mode must be one of: ${ARTIFACT_VIEWPORT_MODES.join(', ')}`);
+        }
+        if (typeof width === 'number' && typeof height === 'number' && typeof mode === 'string') {
+            normalizedViewport = {
+                width: Math.round(width),
+                height: Math.round(height),
+                mode: mode,
+            };
+        }
+    }
+    const entrypoint = normalizeString(input.entrypoint);
+    if (!entrypoint || !isSafePath(entrypoint)) {
+        errors.push('entrypoint must be a safe relative file path');
+    }
+    const files = input.files;
+    const normalizedFiles = {};
+    if (!isRecord(files)) {
+        errors.push('files must be an object of text file paths to string contents');
+    }
+    else {
+        const entries = Object.entries(files);
+        if (entries.length === 0)
+            errors.push('files must contain at least one file');
+        for (const [path, content] of entries) {
+            if (!isSafePath(path)) {
+                errors.push(`file path "${path}" must be a safe relative path`);
+                continue;
+            }
+            const ext = extensionOf(path);
+            if (!TEXT_EXTENSIONS.has(ext)) {
+                errors.push(`file "${path}" must be a supported text file`);
+            }
+            if (typeof content !== 'string') {
+                errors.push(`file "${path}" must be a string`);
+                continue;
+            }
+            normalizedFiles[path] = content;
+        }
+    }
+    if (entrypoint && !Object.prototype.hasOwnProperty.call(normalizedFiles, entrypoint)) {
+        errors.push('entrypoint must exist in files');
+    }
+    const declaredLibraries = new Set();
+    if (input.libraries !== undefined) {
+        if (!Array.isArray(input.libraries)) {
+            errors.push('libraries must be an array when provided');
+        }
+        else {
+            for (const library of input.libraries) {
+                if (typeof library !== 'string' || !ARTIFACT_LIBRARY_KEYS.includes(library)) {
+                    errors.push(`libraries must contain only: ${ARTIFACT_LIBRARY_KEYS.join(', ')}`);
+                    continue;
+                }
+                declaredLibraries.add(library);
+            }
+        }
+    }
+    let display;
+    if (input.display !== undefined) {
+        if (!isRecord(input.display)) {
+            errors.push('display must be an object when provided');
+        }
+        else {
+            display = {};
+            if (input.display.fullscreenFit !== undefined) {
+                if (typeof input.display.fullscreenFit !== 'string'
+                    || !ARTIFACT_FULLSCREEN_FITS.includes(input.display.fullscreenFit)) {
+                    errors.push(`display.fullscreenFit must be one of: ${ARTIFACT_FULLSCREEN_FITS.join(', ')}`);
+                }
+                else {
+                    display.fullscreenFit = input.display.fullscreenFit;
+                }
+            }
+            if (input.display.background !== undefined) {
+                if (typeof input.display.background !== 'string'
+                    || !ARTIFACT_DISPLAY_BACKGROUNDS.includes(input.display.background)) {
+                    errors.push(`display.background must be one of: ${ARTIFACT_DISPLAY_BACKGROUNDS.join(', ')}`);
+                }
+                else {
+                    display.background = input.display.background;
+                }
+            }
+            if (input.display.fullscreenViewport !== undefined) {
+                if (!isRecord(input.display.fullscreenViewport)) {
+                    errors.push('display.fullscreenViewport must be an object when provided');
+                }
+                else {
+                    const width = input.display.fullscreenViewport.width;
+                    const height = input.display.fullscreenViewport.height;
+                    if (typeof width !== 'number' || !Number.isFinite(width) || width < 120 || width > 10000) {
+                        errors.push('display.fullscreenViewport.width must be between 120 and 10000');
+                    }
+                    if (typeof height !== 'number' || !Number.isFinite(height) || height < 120 || height > 10000) {
+                        errors.push('display.fullscreenViewport.height must be between 120 and 10000');
+                    }
+                    if (typeof width === 'number' && typeof height === 'number') {
+                        display.fullscreenViewport = {
+                            width: Math.round(width),
+                            height: Math.round(height),
+                        };
+                    }
+                }
+            }
+            if (input.display.controls !== undefined) {
+                if (!isRecord(input.display.controls)) {
+                    errors.push('display.controls must be an object when provided');
+                }
+                else {
+                    const controls = {};
+                    let hasControls = false;
+                    if (input.display.controls.stepper !== undefined) {
+                        if (!isRecord(input.display.controls.stepper)) {
+                            errors.push('display.controls.stepper must be an object when provided');
+                        }
+                        else {
+                            const stepper = {};
+                            if (input.display.controls.stepper.selector !== undefined) {
+                                const selector = normalizeString(input.display.controls.stepper.selector);
+                                if (!selector || selector.length > 180) {
+                                    errors.push('display.controls.stepper.selector must be a non-empty string up to 180 characters');
+                                }
+                                else {
+                                    stepper.selector = selector;
+                                }
+                            }
+                            if (input.display.controls.stepper.label !== undefined) {
+                                const label = normalizeString(input.display.controls.stepper.label);
+                                if (!label || label.length > 40) {
+                                    errors.push('display.controls.stepper.label must be a non-empty string up to 40 characters');
+                                }
+                                else {
+                                    stepper.label = label;
+                                }
+                            }
+                            controls.stepper = stepper;
+                            hasControls = true;
+                        }
+                    }
+                    if (input.display.controls.reset !== undefined) {
+                        if (typeof input.display.controls.reset !== 'boolean') {
+                            errors.push('display.controls.reset must be a boolean when provided');
+                        }
+                        else {
+                            controls.reset = input.display.controls.reset;
+                            hasControls = true;
+                        }
+                    }
+                    if (hasControls)
+                        display.controls = controls;
+                }
+            }
+            if (Object.keys(display).length === 0)
+                display = undefined;
+        }
+    }
+    let source;
+    if (input.source !== undefined) {
+        if (!isRecord(input.source)) {
+            errors.push('source must be an object when provided');
+        }
+        else {
+            source = {};
+            for (const key of ['repo', 'entityType', 'entityId', 'skillId']) {
+                if (input.source[key] !== undefined) {
+                    const value = normalizeString(input.source[key]);
+                    if (!value)
+                        errors.push(`source.${key} must be a non-empty string`);
+                    else
+                        source[key] = value;
+                }
+            }
+        }
+    }
+    if (errors.length > 0 || !artifactId || !title || !kind || !entrypoint || !normalizedViewport) {
+        return { ok: false, errors, byteSize };
+    }
+    const libraries = Array.from(new Set([...declaredLibraries, ...inferArtifactLibraries(normalizedFiles)]));
+    return {
+        ok: true,
+        errors: [],
+        byteSize,
+        bundle: {
+            schemaVersion: ARTIFACT_BUNDLE_SCHEMA_VERSION,
+            artifactId,
+            title,
+            kind: kind,
+            viewport: normalizedViewport,
+            ...(display ? { display } : {}),
+            ...(libraries.length > 0 ? { libraries } : {}),
+            files: normalizedFiles,
+            entrypoint,
+            ...(source ? { source } : {}),
+        },
+    };
+}
+export function assertArtifactBundle(input) {
+    const result = validateArtifactBundle(input);
+    if (!result.ok || !result.bundle) {
+        throw new Error(result.errors.join('; ') || 'Invalid artifact bundle');
+    }
+    return result.bundle;
+}
+//# sourceMappingURL=artifact-bundle.js.map

package/dist/core/artifact-bundle.js.map

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

package/dist/core/artifact-export.d.ts

@@ -0,0 +1,83 @@
+import type { ArtifactBundle, ArtifactLibraryKey } from './artifact-bundle.js';
+import { type AssetResolution } from './artifact-asset-resolution.js';
+/** The neutral gray the hosted app presents artifacts on. The web stage rule
+ *  (.artifact-stage[data-view-mode='fullscreen'] in ArtifactEntityView.svelte)
+ *  must use the same value — a source-sync test pins it. */
+export declare const ARTIFACT_PRESENT_BACKDROP = "#4a4a4a";
+/** Shared dead-band for content-size churn, in px. Single-sourced HERE (core)
+ *  so the iframe runtime — which interpolates it into its injected reporter
+ *  script below — and the web host's per-slot recorder (which re-exports this
+ *  through artifact-view-state.ts) can never drift apart: a tuning change one
+ *  side silently filtered out would ship as a no-op. */
+export declare const CONTENT_SIZE_DEAD_BAND_PX = 8;
+export type ArtifactExportExtension = 'html' | 'png' | 'pdf';
+/** Where this render runs (eng review D2 — host mode is EXPLICIT):
+ *   - `iframe`: a live host owns the chrome (selection outlines, zoom/pan,
+ *     overview scaling, presentation controls). The runtime is interactive and
+ *     emits its state to the parent via postMessage. The in-app canvas + the
+ *     public share/present page.
+ *   - `none`: no host. The downloaded standalone HTML and the headless
+ *     Playwright render. The runtime owns minimal self-contained chrome (step
+ *     frames + self-fit), capability-frozen at today's export parity — a fence,
+ *     not a growth surface. */
+export type ArtifactRenderHost = 'iframe' | 'none';
+export type ArtifactRenderContextName = 'editor' | 'fullscreen' | 'export';
+export type ArtifactCanvasTool = 'pointer' | 'hand';
+export type ArtifactLibrarySourceKey = ArtifactLibraryKey | 'threeCore';
+export type ArtifactLibrarySources = Partial<Record<ArtifactLibrarySourceKey, string>>;
+export declare function artifactExportFilename(bundle: Pick<ArtifactBundle, 'artifactId' | 'title'>, extension?: ArtifactExportExtension): string;
+/** How workspace-asset refs resolve in THIS render — drives both the URL
+ *  rewrite and the document CSP from one value (see
+ *  artifact-asset-resolution.ts). */
+export interface ArtifactRenderContext {
+    host: ArtifactRenderHost;
+    /** The render surface. Drives the `data-artifact-context` attribute + runtime
+     *  gating. For host `iframe` it defaults to `editor`. For host `none` it may
+     *  be left undefined — a plain self-contained export with no context chrome
+     *  (the bare `buildArtifactHtmlExport(bundle)` case). */
+    context?: ArtifactRenderContextName;
+    tool?: ArtifactCanvasTool;
+    assets?: AssetResolution;
+    librarySources?: ArtifactLibrarySources;
+    /** Base URL for the headless (Playwright) render path so root-relative
+     *  `/api/assets/...` URLs resolve in a `setContent` document. The CSP's
+     *  `base-uri` is widened to exactly this origin. Never set on the standalone
+     *  HTML export — a downloaded file must not phone home. (host: 'none' only) */
+    baseHref?: string;
+    /** Emit the render-host styles (export-frame flattening, print pagination,
+     *  in-document present backdrop). The Playwright + standalone-export paths
+     *  set it; the in-app iframe never does. (host: 'none' only) */
+    includeRenderHostStyles?: boolean;
+}
+/**
+ * THE single artifact document builder (eng review D2). Every render context —
+ * in-app canvas, public share/present page, downloaded standalone HTML, and the
+ * headless Playwright render — produces its HTML here, from one set of
+ * content-processing helpers and one runtime. `host` selects the document SHAPE
+ * (a live-hosted iframe srcdoc vs a self-contained file) and the runtime's
+ * capabilities; the asset CSP + URL rewrite come from the one `assets` value.
+ */
+export declare function buildArtifactDocument(bundle: ArtifactBundle, ctx: ArtifactRenderContext): string;
+export interface ArtifactHtmlExportOptions {
+    context?: 'editor' | 'fullscreen' | 'export';
+    /** Base URL for the headless (Playwright) render path so root-relative
+     *  `/api/assets/...` URLs resolve in a `setContent` document. The CSP's
+     *  `base-uri` is widened to exactly this origin. Never set on the
+     *  standalone HTML export — a downloaded file must not phone home. */
+    baseHref?: string;
+    includeRenderHostStyles?: boolean;
+    librarySources?: ArtifactLibrarySources;
+    /** How workspace-asset refs resolve in THIS render — drives both the URL
+     *  rewrite and the document CSP from one value (see
+     *  artifact-asset-resolution.ts). Headless PNG/PDF passes token mode; the
+     *  self-contained HTML export passes relative mode. Defaults to none
+     *  (no asset access). */
+    assets?: AssetResolution;
+}
+/**
+ * Self-contained HTML export + headless Playwright render. A thin adapter over
+ * {@link buildArtifactDocument} with `host: 'none'` — kept for its existing
+ * callers (the export route, MCP `export_artifact`, the render service). A
+ * bare call (no `context`) yields a plain self-contained file, unchanged.
+ */
+export declare function buildArtifactHtmlExport(bundle: ArtifactBundle, options?: ArtifactHtmlExportOptions): string;