@sanity-labs/slides 0.0.0

package/dist/core/reconciler.js

@@ -0,0 +1,453 @@
+/**
+ * The reconciler — walks a React element tree and emits a sequence of
+ * `SlideOp`s plus a generation manifest.
+ *
+ * # Why a custom walker (not `react-reconciler`)
+ *
+ * The natural reach is for the `react-reconciler` package — it's what
+ * react-three-fiber, react-pdf, and Ink use. But the constraints of this
+ * surface make a custom walker a strictly simpler fit:
+ *
+ * 1. **No state.** Template components are pure. No hooks, no effects, no refs.
+ *    The whole reason to use `react-reconciler` is the scheduler + commit
+ *    phases that make state-driven re-renders work. We don't have state.
+ * 2. **Write-once.** A `renderToOps()` call produces one batch and exits.
+ *    There's no incremental update model to honor.
+ * 3. **No host node mutation.** Output is an immutable op list. The 30+ host-
+ *    config methods `react-reconciler` requires (`appendChild`,
+ *    `removeChild`, `commitMount`, etc.) all collapse to "push to an array."
+ * 4. **Tree shape is shallow and known.** `Slide` → `Box` | `Image` →
+ *    text runs. The walker can encode this structure directly with much
+ *    better error messages than a generic reconciler would surface.
+ *
+ * If we ever add state-driven re-renders (probably never; the docs commit to
+ * forward-only generation), we can swap in `react-reconciler` behind the same
+ * `renderToOps` signature. The signature is the contract.
+ *
+ * # What the walker does
+ *
+ * 1. Resolve function components by invoking them with their props (no hooks).
+ * 2. Flatten fragments and arrays.
+ * 3. For each `<Slide>`, emit `createSlide`, then walk its children for
+ *    `<Box>`s and `<Image>`s.
+ * 4. For each `<Box>`, emit `createShape` (TEXT_BOX), then — if `fill` is
+ *    set — `updateShapeProperties` carrying the resolved fill color, then
+ *    collect its text runs into a single `insertText` + per-run
+ *    `updateTextStyle` calls.
+ * 5. For each `<Image>`, emit `createImage` with the resolved URL and (if
+ *    no slotId is set) the user-supplied alt-text. Record the artifact
+ *    reference in the manifest, deduped by identifier.
+ *
+ * Errors throw with paths like "Slide[0] > Box[1] > unexpected child" so the
+ * brand-component author has enough information to localize the problem.
+ *
+ * # Determinism
+ *
+ * Object IDs are generated from a counter seeded per call. Same input tree →
+ * same output ops → same snapshot. This is what makes layer-2 golden tests in
+ * `docs/testing-strategy.md` work.
+ */
+import { Children, Fragment, isValidElement, } from 'react';
+import { Box, Color, Text, Image, Slide, isPrimitive, } from './components.js';
+import { isFontRole, resolveFontRole } from './font-resolver.js';
+import { ptToEmu } from './geometry.js';
+/**
+ * Render a React tree to ops + manifest.
+ *
+ * The function is synchronous: function components are invoked inline, and the
+ * walk is purely structural. There's no scheduling, no async boundaries.
+ */
+export const renderToOps = (input) => {
+    const ctx = {
+        template: input.template,
+        ops: [],
+        slots: new Map(),
+        artifacts: new Map(),
+        idCounter: 0,
+        currentSlideIndex: -1,
+        currentBoxIndex: -1,
+    };
+    // Seed with caller-supplied artifacts first so reconciler-discovered
+    // artifacts on the same identifier overwrite (more recent / context-bound
+    // resolution wins). Insertion order is preserved.
+    if (input.artifacts !== undefined) {
+        for (const artifact of input.artifacts) {
+            ctx.artifacts.set(artifact.identifier, artifact);
+        }
+    }
+    const slides = collectSlides(input.tree, ctx);
+    slides.forEach((slide, index) => {
+        ctx.currentSlideIndex = index;
+        ctx.currentBoxIndex = -1;
+        walkSlide(slide, index, ctx);
+    });
+    const manifest = {
+        manifestVersion: '1',
+        generatedBy: 'react-pptx',
+        generatedAt: (input.now ?? defaultNow)(),
+        templateName: input.template.name,
+        deckId: input.deckId,
+        slots: Object.fromEntries(ctx.slots),
+        artifacts: [...ctx.artifacts.values()],
+    };
+    return { ops: ctx.ops, manifest };
+};
+const defaultNow = () => new Date().toISOString();
+// ---------------------------------------------------------------------------
+// Tree walk
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a node to its concrete element form, invoking function components.
+ *
+ * Returns:
+ * - An array of resolved primitives if the node is a fragment / array / function
+ *   component that returned multiple children.
+ * - A single primitive element if the node resolves to one.
+ * - Empty array for falsy / boolean / null nodes (React's "render nothing").
+ *
+ * This is what makes `<Cover/>` work: `Cover` is a function component that
+ * returns `<Slide>...</Slide>`, so resolving it yields the underlying Slide.
+ */
+const resolveNode = (node, ctx) => {
+    if (node === null || node === undefined || node === false || node === true) {
+        return [];
+    }
+    if (typeof node === 'string' || typeof node === 'number') {
+        throw new ReconcilerError(`Unexpected text node "${node}" at top level — text must live inside a <Box>.`, ctx);
+    }
+    if (Array.isArray(node)) {
+        return node.flatMap((child) => resolveNode(child, ctx));
+    }
+    if (!isValidElement(node)) {
+        throw new ReconcilerError(`Unsupported child of type ${typeof node}.`, ctx);
+    }
+    // React.Fragment: descend into children.
+    if (node.type === Fragment) {
+        const props = node.props;
+        return resolveNode(props.children, ctx);
+    }
+    // Primitive host element: pass through.
+    if (isPrimitive(node.type)) {
+        return [node];
+    }
+    // Function component: invoke with its props (no hooks; brand components are pure).
+    if (typeof node.type === 'function') {
+        const Component = node.type;
+        const result = invokeComponent(Component, node.props, ctx);
+        return resolveNode(result, ctx);
+    }
+    // Class components, intrinsic strings, etc.: not supported.
+    const typeName = describeType(node.type);
+    throw new ReconcilerError(`Unsupported element type ${typeName}.`, ctx);
+};
+const collectSlides = (tree, ctx) => {
+    const resolved = resolveNode(tree, ctx);
+    for (const el of resolved) {
+        if (el.type !== Slide) {
+            throw new ReconcilerError(`Top-level children must be <Slide> elements; got <${describeType(el.type)}>.`, ctx);
+        }
+    }
+    return resolved;
+};
+const walkSlide = (slide, index, ctx) => {
+    const props = slide.props;
+    const slideId = makeId('slide', ctx);
+    ctx.ops.push({
+        type: 'createSlide',
+        slideId,
+        insertAt: index,
+    });
+    const children = resolveNode(props.children, ctx);
+    children.forEach((child, childIndex) => {
+        ctx.currentBoxIndex = childIndex;
+        if (child.type === Box) {
+            walkBox(child, slideId, ctx);
+            return;
+        }
+        if (child.type === Image) {
+            walkImage(child, slideId, ctx);
+            return;
+        }
+        throw new ReconcilerError(`<Slide> children must be <Box> or <Image> elements; got <${describeType(child.type)}>.`, ctx);
+    });
+};
+const walkBox = (box, slideId, ctx) => {
+    const props = box.props;
+    const shapeId = makeId('shape', ctx);
+    ctx.ops.push({
+        type: 'createShape',
+        slideId,
+        shapeId,
+        shape: 'TEXT_BOX',
+        rect: rectToEmu(props.rect),
+    });
+    // Fill applies to the shape itself, before any text. Order matters:
+    //   createShape → updateShapeProperties → insertText → updateTextStyle
+    // This way an empty Box with a fill is a valid full-bleed colored
+    // background, and a Box with both fill and text gets the fill behind the
+    // text without any z-order ambiguity.
+    if (props.fill !== undefined) {
+        const properties = boxFillToShapeProperties(props.fill);
+        ctx.ops.push({
+            type: 'updateShapeProperties',
+            objectId: shapeId,
+            properties,
+        });
+    }
+    if (props.slotId !== undefined) {
+        if (ctx.slots.has(props.slotId)) {
+            throw new ReconcilerError(`Duplicate slotId "${props.slotId}" — slot IDs must be unique within a deck.`, ctx);
+        }
+        ctx.slots.set(props.slotId, shapeId);
+        // Slot identity is encoded into shape alt-text per generation-model.md.
+        // We re-use `updateShapeProperties` semantics by piggybacking through a
+        // dedicated op-shape — here, alt-text is set via a property update at the
+        // runtime layer. The op carries no fillColor/outlineColor, signalling
+        // "alt text only." If alt-text ever deserves its own op type, this is the
+        // keeps the SlideOp union narrow.
+        //
+        // NOTE: `updateShapeProperties` doesn't currently carry alt-text; the
+        // runtime adapter resolves slot alt-text from the manifest's `slots` map,
+        // not from an op. The manifest is the source of truth for slot identity.
+        // This is intentional: ops express "what to do," manifest expresses "what
+        // is true after." Encoding alt-text into ops would duplicate the manifest
+        // entry.
+    }
+    // Default styles to apply across the whole shape after text is inserted.
+    const text = collectTextRuns(props.children, ctx);
+    if (text.runs.length === 0) {
+        // Empty Box is permitted (colored rectangle, full-bleed background).
+        return;
+    }
+    ctx.ops.push({ type: 'insertText', objectId: shapeId, text: text.full });
+    if (props.textStyle !== undefined && Object.keys(props.textStyle).length > 0) {
+        ctx.ops.push({
+            type: 'updateTextStyle',
+            objectId: shapeId,
+            range: { start: 0, end: text.full.length },
+            style: resolveTextStyleFonts(props.textStyle, ctx.template, ctx),
+        });
+    }
+    if (props.paragraphStyle !== undefined && Object.keys(props.paragraphStyle).length > 0) {
+        ctx.ops.push({
+            type: 'updateParagraphStyle',
+            objectId: shapeId,
+            range: { start: 0, end: text.full.length },
+            style: props.paragraphStyle,
+        });
+    }
+    for (const run of text.runs) {
+        if (Object.keys(run.style).length === 0)
+            continue;
+        ctx.ops.push({
+            type: 'updateTextStyle',
+            objectId: shapeId,
+            range: run.range,
+            style: resolveTextStyleFonts(run.style, ctx.template, ctx),
+        });
+    }
+};
+/**
+ * Walk an `<Image>` element: emit a `createImage` op and record the artifact.
+ *
+ * Slot/altText interaction: the reconciler emits `createImage` with the
+ * user-supplied `altText` (if any) — that's what lands in the FakeRuntime's
+ * in-memory model and what the live runtime's translator will set as the
+ * page-element description initially. If a `slotId` is also set, the
+ * runtime adapter's slot-stamping post-pass
+ * (`op-translator.slotRegistryToAltTextRequests`) overwrites the live
+ * page-element alt-text with the slot tag, because slot identity is required
+ * for re-fill and wins. The op stream still carries the user altText, so the
+ * substrate doesn't lose it.
+ */
+const walkImage = (image, slideId, ctx) => {
+    const props = image.props;
+    const imageId = makeId('image', ctx);
+    ctx.ops.push({
+        type: 'createImage',
+        slideId,
+        imageId,
+        url: props.image.url,
+        rect: rectToEmu(props.rect),
+        ...(props.altText !== undefined ? { altText: props.altText } : {}),
+    });
+    // Dedup by identifier: a logo or texture referenced from many slides should
+    // appear in manifest.artifacts exactly once. Last-wins on conflicts (later
+    // resolution overrides earlier) — typically a no-op since the brand
+    // resolver is deterministic per identifier.
+    ctx.artifacts.set(props.image.artifact.identifier, props.image.artifact);
+    if (props.slotId !== undefined) {
+        if (ctx.slots.has(props.slotId)) {
+            throw new ReconcilerError(`Duplicate slotId "${props.slotId}" — slot IDs must be unique within a deck.`, ctx);
+        }
+        ctx.slots.set(props.slotId, imageId);
+    }
+};
+/**
+ * Resolve a `BoxFill` discriminated union to the shape-properties subset the
+ * reconciler emits via `updateShapeProperties`.
+ *
+ * The discriminant (`kind`) is exhaustively switched so adding a new fill
+ * variant in `components.ts` (e.g., `'texture'`) is a compile-time prompt to
+ * extend this resolver as well.
+ */
+const boxFillToShapeProperties = (fill) => {
+    switch (fill.kind) {
+        case 'solid':
+            return { fillColor: fill.color };
+    }
+};
+/**
+ * Recursively collect text runs from a Box's children.
+ *
+ * Rules:
+ * - Strings/numbers contribute raw text with no style.
+ * - `<Text>` nests its own style and contributes its children's text.
+ * - `<Color>` is sugar for `<Text textStyle={{ foregroundColor }}>`.
+ * - Nested function components are resolved (so `<Bullet>foo</Bullet>` works
+ *   if `Bullet` is a brand component returning `<Text>foo</Text>`).
+ * - Anything else is an error.
+ */
+const collectTextRuns = (node, ctx) => {
+    const acc = { full: '', runs: [] };
+    const append = (text, style) => {
+        if (text.length === 0)
+            return;
+        const start = acc.full.length;
+        acc.full += text;
+        acc.runs.push({ range: { start, end: start + text.length }, style });
+    };
+    walkText(node, {}, append, ctx);
+    return acc;
+};
+const walkText = (node, inheritedStyle, append, ctx) => {
+    if (node === null || node === undefined || node === false || node === true) {
+        return;
+    }
+    if (typeof node === 'string') {
+        append(node, inheritedStyle);
+        return;
+    }
+    if (typeof node === 'number') {
+        append(String(node), inheritedStyle);
+        return;
+    }
+    if (Array.isArray(node)) {
+        Children.forEach(node, (child) => walkText(child, inheritedStyle, append, ctx));
+        return;
+    }
+    if (!isValidElement(node)) {
+        throw new ReconcilerError(`Unsupported text child of type ${typeof node}.`, ctx);
+    }
+    if (node.type === Fragment) {
+        const props = node.props;
+        walkText(props.children, inheritedStyle, append, ctx);
+        return;
+    }
+    if (node.type === Text) {
+        const props = node.props;
+        const merged = { ...inheritedStyle, ...(props.textStyle ?? {}) };
+        walkText(props.children, merged, append, ctx);
+        return;
+    }
+    if (node.type === Color) {
+        const props = node.props;
+        const merged = { ...inheritedStyle, foregroundColor: props.color };
+        walkText(props.children, merged, append, ctx);
+        return;
+    }
+    if (node.type === Slide || node.type === Box || node.type === Image) {
+        throw new ReconcilerError(`<${describeType(node.type)}> cannot appear inside a <Box>.`, ctx);
+    }
+    if (typeof node.type === 'function') {
+        const Component = node.type;
+        const result = invokeComponent(Component, node.props, ctx);
+        walkText(result, inheritedStyle, append, ctx);
+        return;
+    }
+    throw new ReconcilerError(`Unsupported text element <${describeType(node.type)}>.`, ctx);
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve any role-string `fontFamily` in a `TextStyle` to a literal family
+ * name using the brand's font stack. Returns the same object reference if the
+ * style has no role-string `fontFamily` (the common case for literal-family
+ * passes — preserves snapshot stability and avoids unnecessary allocation).
+ *
+ * Resolution semantics (no backend querying):
+ *   role keyword in → `brand.fonts[role][0]` out (the brand's first preference).
+ *
+ * If the brand declares an empty stack for the requested role, this throws
+ * with a clear "brand defines no <role> font" error. Strict-fail beats
+ * silent-Arial when the source of truth is misconfigured.
+ *
+ * The reconciler invokes this immediately before pushing every text-style op,
+ * so downstream translators never see a role keyword as a literal family.
+ */
+const resolveTextStyleFonts = (style, template, ctx) => {
+    const family = style.fontFamily;
+    if (family === undefined)
+        return style;
+    if (!isFontRole(family))
+        return style; // literal family — pass through.
+    try {
+        return { ...style, fontFamily: resolveFontRole(template.fonts, family) };
+    }
+    catch (err) {
+        if (err instanceof Error && err.name === 'EmptyFontStackError') {
+            throw new ReconcilerError(`Template "${template.name}" defines no ${family} font (fonts.${family} is empty). Every role needs at least one entry, with a system-safe last entry (e.g., "Arial").`, ctx);
+        }
+        throw err;
+    }
+};
+const rectToEmu = (rect) => ({
+    x: ptToEmu(rect.x),
+    y: ptToEmu(rect.y),
+    w: ptToEmu(rect.w),
+    h: ptToEmu(rect.h),
+});
+const makeId = (prefix, ctx) => {
+    ctx.idCounter += 1;
+    return `${prefix}_${ctx.idCounter}`;
+};
+/**
+ * Invoke a function component with its props and return its rendered children.
+ *
+ * Async components are not supported. React 19 widened the function-component
+ * return type to `ReactNode | Promise<ReactNode>`; we narrow back to
+ * `ReactNode` here and throw if a Promise is returned.
+ */
+const invokeComponent = (Component, props, ctx) => {
+    const result = Component(props);
+    if (typeof result === 'object' && result !== null && 'then' in result) {
+        throw new ReconcilerError(`<${describeType(Component)}> returned a Promise. Template components must be synchronous (no async, no Suspense).`, ctx);
+    }
+    return result;
+};
+const describeType = (type) => {
+    if (typeof type === 'string')
+        return type;
+    if (typeof type === 'function') {
+        const named = type;
+        return named.displayName ?? named.name ?? 'anonymous';
+    }
+    if (type === Fragment)
+        return 'Fragment';
+    return String(type);
+};
+/** Error thrown by the reconciler with location info pre-formatted. */
+export class ReconcilerError extends Error {
+    constructor(message, ctx) {
+        const path = [];
+        if (ctx.currentSlideIndex >= 0)
+            path.push(`Slide[${ctx.currentSlideIndex}]`);
+        if (ctx.currentBoxIndex >= 0)
+            path.push(`Box[${ctx.currentBoxIndex}]`);
+        const prefix = path.length > 0 ? `${path.join(' > ')}: ` : '';
+        super(`${prefix}${message}`);
+        this.name = 'ReconcilerError';
+    }
+}
+//# sourceMappingURL=reconciler.js.map

package/dist/core/reconciler.js.map

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

package/dist/core/runtime.d.ts

@@ -0,0 +1,161 @@
+/**
+ * The seam between the reconciler and the slide runtime backend.
+ *
+ * Production wires `PptxSlidesRuntime` into the reconciler. Tests wire
+ * `FakeSlidesRuntime` which records every operation and builds an in-memory
+ * deck model.
+ *
+ * See `docs/testing-strategy.md` for the rationale.
+ */
+import type { Emu } from './geometry.js';
+import type { GenerationManifest } from './manifest.js';
+/**
+ * A typed Slides API operation the reconciler emits.
+ *
+ * This is intentionally NOT a 1:1 mapping of any specific slide API — it's
+ * the *intent* the reconciler emits, with EMU and IDs already resolved. The
+ * runtime adapter turns these into backend-specific operations.
+ *
+ * Keeping ops at this layer (vs raw API requests) means:
+ * 1. Goldens read clearly. `{ type: "createShape", ... }` beats a 50-line nested object.
+ * 2. The API can evolve underneath without churning every test snapshot.
+ * 3. Template-agnostic; nothing here is Sanity-specific.
+ */
+export type SlideOp = {
+    type: 'createSlide';
+    slideId: string;
+    insertAt?: number;
+} | {
+    type: 'createShape';
+    slideId: string;
+    shapeId: string;
+    shape: ShapeKind;
+    rect: EmuRect;
+} | {
+    type: 'insertText';
+    objectId: string;
+    text: string;
+} | {
+    type: 'updateTextStyle';
+    objectId: string;
+    range: TextRange;
+    style: TextStyle;
+} | {
+    type: 'updateParagraphStyle';
+    objectId: string;
+    range: TextRange;
+    style: ParagraphStyle;
+} | {
+    type: 'createImage';
+    slideId: string;
+    imageId: string;
+    url: string;
+    rect: EmuRect;
+    altText?: string;
+} | {
+    type: 'updateShapeProperties';
+    objectId: string;
+    properties: ShapeProperties;
+};
+/** A rectangle in EMU — the reconciler converts pt → EMU before emitting. */
+export interface EmuRect {
+    x: Emu;
+    y: Emu;
+    w: Emu;
+    h: Emu;
+}
+/**
+ * Shape kinds the reconciler emits. Names mirror the Office Open XML /
+ * Google Slides API enum so translators on either side can pass through
+ * without a lookup table.
+ */
+export type ShapeKind = 'TEXT_BOX' | 'RECTANGLE' | 'ELLIPSE' | 'LINE';
+/** Inclusive-exclusive index range over a string of text. */
+export interface TextRange {
+    start: number;
+    end: number;
+}
+/**
+ * A font role keyword. Resolved against `Template.fonts[role][0]` at the
+ * reconciler boundary; the role keywords (`'display'` / `'body'` / `'mono'`)
+ * are reserved — a brand cannot have a literal font family named "display."
+ *
+ * See `reconciler.ts` for resolution semantics; the role keywords mirror
+ * `FontStack` keys so adding a role to one ripples to the other.
+ */
+export type FontRole = 'display' | 'body' | 'mono';
+/** Text-style properties supported at the reconciler boundary. */
+export interface TextStyle {
+    /**
+     * Font family. Either:
+     * - A role keyword (`'display'` / `'body'` / `'mono'`), resolved against
+     *   `Template.fonts[role][0]` at the reconciler boundary before the op is
+     *   emitted. This is what brand components and `<Text/>` consumers
+     *   should pass — it keeps the brand's font choice load-bearing.
+     * - A literal family name (e.g., `'Geist'`, `'Inter'`), passed through
+     *   verbatim. Template authors with a specific family in mind use this.
+     *
+     * The role keywords are reserved — they shadow any literal family of the
+     * same name. If a future brand needed a literal `'display'` family, the
+     * shape would need to migrate to a discriminated union.
+     *
+     * Why a string union (vs. discriminated): the role keywords are vanishingly
+     * unlikely to ever be a real family; a discriminated union would force every
+     * literal-family consumer to write `{ kind: 'family', family: ... }` for no
+     * win. `flatten-for-brand.ts:inferFontRole` returns role strings directly,
+     * which compose cleanly into this shape.
+     */
+    fontFamily?: FontRole | string;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    foregroundColor?: HexColor;
+    backgroundColor?: HexColor;
+}
+/** Paragraph-style properties supported at the reconciler boundary. */
+export interface ParagraphStyle {
+    alignment?: 'START' | 'CENTER' | 'END' | 'JUSTIFIED';
+    lineSpacing?: number;
+    spaceAbove?: number;
+    spaceBelow?: number;
+}
+/** Shape-level visual properties. */
+export interface ShapeProperties {
+    fillColor?: HexColor;
+    outlineColor?: HexColor;
+    outlineWeight?: number;
+}
+/** A 24-bit hex color, e.g., "#FF5500". The reconciler converts to RGB at emit. */
+export type HexColor = `#${string}`;
+/**
+ * The runtime contract every slide backend satisfies. This is the seam that
+ * makes layered testing work — see `docs/testing-strategy.md`.
+ */
+export interface SlidesRuntime {
+    /** Apply a sequence of slide operations to a deck. */
+    applyOps(deckId: string, ops: readonly SlideOp[]): Promise<ApplyOpsResult>;
+    /**
+     * Create a new deck, optionally seeded from a template reference.
+     *
+     * `masterRef` is opaque to the substrate; runtimes that don't have a
+     * master-template concept ignore it and initialize a blank deck.
+     */
+    createDeckFromMaster(masterRef: string, title: string): Promise<{
+        deckId: string;
+    }>;
+    /** Write the deck to a file on disk. Returns the absolute path. */
+    write(deckId: string): Promise<{
+        filePath: string;
+    }>;
+    /** Attach a manifest to a deck (for later retrieval). */
+    attachManifest(deckId: string, manifest: GenerationManifest): void;
+}
+/** What the runtime returns after applying a batch of ops. */
+export interface ApplyOpsResult {
+    /** IDs of objects created during this batch, keyed by the requested ID. */
+    createdObjectIds: Readonly<Record<string, string>>;
+    /** Revision token for optimistic-concurrency on the next call. */
+    revisionId?: string;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/runtime.d.ts.map

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

package/dist/core/runtime.js

@@ -0,0 +1,11 @@
+/**
+ * The seam between the reconciler and the slide runtime backend.
+ *
+ * Production wires `PptxSlidesRuntime` into the reconciler. Tests wire
+ * `FakeSlidesRuntime` which records every operation and builds an in-memory
+ * deck model.
+ *
+ * See `docs/testing-strategy.md` for the rationale.
+ */
+export {};
+//# sourceMappingURL=runtime.js.map

package/dist/core/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}