@json-to-office/core-pptx 0.36.0 → 1.2.0

package/dist/ir/compiler.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Compile a processed presentation into PptxIR.
+ *
+ * The input is `ProcessedPresentation` — the authoring tree after schema
+ * validation, custom-component expansion, theme resolution and component
+ * defaults. What remains, and what this module does, is the last mile of
+ * resolution: grid cells become EMU transforms, placeholder content is merged
+ * with its declaration, theme colour tokens become hex, the font cascade is
+ * flattened onto every run, and page-number placeholders are substituted.
+ *
+ * No renderer is imported here, and none may be. The output is plain data.
+ *
+ * Scope: this is the Phase 2 vertical slice — metadata, slide size, slides,
+ * solid backgrounds, text bodies (single and rich-run), images and preset
+ * shapes. Component kinds outside that slice are reported through
+ * `unsupported`, so a caller can tell "not yet compiled" from "compiled to
+ * nothing".
+ */
+import { type FeatureRequirement } from '@json-to-office/shared/rendering';
+import type { PipelineWarning, ProcessedPresentation } from '../types';
+import type { PptxFeature } from './features';
+import { type PptxIR } from './types';
+/** A component kind the compiler does not yet lower into IR. */
+export interface UnsupportedComponent {
+    name: string;
+    path: string;
+}
+export interface PptxCompileResult {
+    ir: PptxIR;
+    /** Backend capabilities the IR needs, with the IR path that needs them. */
+    required: readonly FeatureRequirement<PptxFeature>[];
+    warnings: PipelineWarning[];
+    /**
+     * Components the compiler could not lower. Empty once the migration is
+     * complete; until then this is what keeps the legacy path authoritative
+     * instead of silently dropping content.
+     */
+    unsupported: UnsupportedComponent[];
+}
+export declare function compilePresentation(processed: ProcessedPresentation, warnings?: PipelineWarning[]): PptxCompileResult;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/ir/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/ir/compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,KAAK,EAEV,eAAe,EAGf,qBAAqB,EAKtB,MAAM,UAAU,CAAC;AAalB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,OAAO,EAGL,KAAK,MAAM,EA+BZ,MAAM,SAAS,CAAC;AAWjB,gEAAgE;AAChE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;IACrD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B;;;;OAIG;IACH,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAeD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,qBAAqB,EAChC,QAAQ,GAAE,eAAe,EAAO,GAC/B,iBAAiB,CAmDnB"}

package/dist/ir/debug.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Stable debug snapshots of PptxIR.
+ *
+ * A snapshot is the IR with every binary resource replaced by its content hash
+ * and byte length, and object keys emitted in a fixed order. That makes it
+ * diffable in a test and readable in a bug report, without base64-inflating
+ * megabytes of image data into the snapshot file.
+ *
+ * The transform is lossless for everything a reviewer cares about and lossy
+ * only for bytes, which are identified by hash instead.
+ */
+import type { PptxIR } from './types';
+/** A JSON-safe view of the IR, suitable for `toMatchSnapshot`. */
+export type PptxIrSnapshot = Record<string, unknown>;
+export declare function snapshotPptxIr(ir: PptxIR): PptxIrSnapshot;
+/** Render a snapshot as stable, pretty-printed JSON. */
+export declare function formatPptxIr(ir: PptxIR): string;
+//# sourceMappingURL=debug.d.ts.map

package/dist/ir/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/ir/debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,SAAS,CAAC;AAEtD,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAKzD;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/ir/features.d.ts

@@ -0,0 +1,18 @@
+/**
+ * PPTX renderer features.
+ *
+ * A feature is a capability a *backend* must have, not an authoring concept.
+ * The compiler records one requirement per IR node that needs one; a renderer
+ * declares the set it can satisfy. Anything required but not declared fails
+ * before rendering, with the IR path attached.
+ *
+ * Names are chosen so the boundary is real: `gradient-fills` is separate from
+ * `pattern-fills` because a backend can plausibly have one and not the other,
+ * while `rich-text` covers multi-run bodies as a single indivisible ability.
+ */
+export declare const PPTX_FEATURES: readonly ["masters", "placeholders", "rich-text", "complex-bullet-glyphs", "text", "shapes", "images", "svg", "image-crop", "image-rounding", "tables", "table-merged-cells", "table-insets", "table-rounded-corners", "table-auto-page", "charts", "solid-fills", "gradient-fills", "pattern-fills", "image-fills", "lines", "shadows", "backgrounds", "speaker-notes", "hidden-slides", "transitions", "external-links", "internal-links", "text-hyperlinks", "element-hyperlinks", "rotation", "image-transform", "flip-horizontal", "flip-vertical", "groups", "proofing-language", "rtl"];
+export type PptxFeature = (typeof PPTX_FEATURES)[number];
+/** Every feature, for an adapter that claims the full surface. */
+export declare const ALL_PPTX_FEATURES: ReadonlySet<PptxFeature>;
+export declare function isPptxFeature(value: string): value is PptxFeature;
+//# sourceMappingURL=features.d.ts.map

package/dist/ir/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/ir/features.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,aAAa,gkBAgGhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,WAAW,CAEtD,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE"}

package/dist/ir/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * PptxIR — internal to `@json-to-office/core-pptx` for this release.
+ *
+ * Deliberately not re-exported from `packages/core-pptx/src/index.ts`: the IR
+ * shape is expected to move while the DOCX side of the migration lands, and
+ * publishing it now would freeze it. See
+ * `docs/architecture/office-renderer-ir.md`.
+ */
+export * from './types';
+export * from './features';
+export * from './units';
+export * from './resources';
+export { compilePresentation } from './compiler';
+export type { PptxCompileResult, UnsupportedComponent } from './compiler';
+export { assertValidPptxIr, validatePptxIr } from './validation';
+export type { IrViolation } from './validation';
+export { formatPptxIr, snapshotPptxIr } from './debug';
+export type { PptxIrSnapshot } from './debug';
+//# sourceMappingURL=index.d.ts.map

package/dist/ir/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ir/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/dist/ir/resources.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Resource table used while compiling a presentation to PptxIR.
+ *
+ * One table per compilation — never module-global — so concurrent generations
+ * cannot share ids or entries.
+ *
+ * Identity depends on where the bytes come from. Inline sources (authored
+ * base64, raw SVG) are decoded once and keyed by content hash, so the same
+ * image authored twice becomes one resource. File and remote sources keep
+ * their location and are keyed by it, because reading every file at compile
+ * time would change when I/O happens and how much of a large deck is resident
+ * in memory.
+ */
+import type { PptxIrPixelSize, PptxIrResource } from './types';
+export interface InlineResourceInput {
+    kind: 'inline';
+    bytes: Uint8Array;
+    mediaType?: string;
+}
+export interface FileResourceInput {
+    kind: 'file';
+    path: string;
+    mediaType?: string;
+}
+export interface RemoteResourceInput {
+    kind: 'remote';
+    url: string;
+    mediaType?: string;
+}
+export type ResourceInput = InlineResourceInput | FileResourceInput | RemoteResourceInput;
+export declare class ResourceTable {
+    private readonly byKey;
+    private readonly order;
+    /**
+     * Add a resource (or return the existing one with matching identity) and
+     * return its id.
+     */
+    intern(input: ResourceInput, intrinsic?: PptxIrPixelSize): string;
+    /** Every resource, in first-use order. */
+    list(): PptxIrResource[];
+    get(id: string): PptxIrResource | undefined;
+}
+/**
+ * Split a `data:` URI into its media type and decoded bytes.
+ *
+ * Returns `undefined` for anything that is not a base64 data URI, so callers
+ * can fall back to treating the string as a location.
+ */
+export declare function parseDataUri(source: string): {
+    mediaType: string;
+    bytes: Uint8Array;
+} | undefined;
+/** Guess a media type from a file extension or URL path. */
+export declare function mediaTypeFromLocation(location: string): string | undefined;
+//# sourceMappingURL=resources.d.ts.map

package/dist/ir/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/ir/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEf,MAAM,SAAS,CAAC;AAGjB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,CAAC;AAExB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAE9C;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,eAAe,GAAG,MAAM;IAsBjE,0CAA0C;IAC1C,IAAI,IAAI,cAAc,EAAE;IAIxB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;CAG5C;AA6BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,GACb;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,SAAS,CAStD;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAyB1E"}