deckjsx 0.5.0 → 0.7.0

package/dist/index.d.mts

@@ -1,7 +1,186 @@
-import { $ as CssJustifyContent, $t as formatDiagnostics, A as SourceContextMapper, B as CssBoxSizing, Ct as TextTabStopAuthoring, D as SlideFactory, Et as ViewStyle, F as BorderStyle, G as CssGridAutoFlow, H as CssFlexBasis, I as CssAlignContent, J as CssGridShorthand, Jt as Diagnostic, K as CssGridLine, L as CssAlignItems, M as ThemeInput, N as ThemeDefaults, O as SlideFactoryInput, P as StyleSheet, Q as CssGridTrack, Qt as formatDiagnostic, R as CssAlignSelf, S as ViewProps, St as TextTabStopAlignment, Tt as VerticalAlign, U as CssFlexDirection, V as CssDisplay, W as CssFlexWrap, X as CssGridTemplateAreas, Xt as DiagnosticSeverity, Y as CssGridTemplate, Yt as DiagnosticLabel, Z as CssGridTemplateShorthand, Zt as Diagnostics, _ as SlideContext, _t as StrokeLineCap, a as ContentJsxChild, at as DeckLength, b as TextProps, bt as TextRunStyle, c as ImageProps, cn as SourceSpan, ct as ImageCropValue, d as IntrinsicImgProps, dt as ShapeStyle, en as CompositionDiagnosticError, et as CssJustifySelf, f as IntrinsicPProps, ft as SlideStyle, g as ShapeProps, gt as StrokeDashType, h as OutputConfig, ht as StackAxis, i as ClassNameValueArray, it as CssVisibility, j as Theme, l as ImplementedBackendName, lt as ImageStyle, m as IntrinsicViewTag, mt as StackAlignment, n as ClassNameObject, nn as SemanticGraphDiagnosticError, nt as CssOverflow, o as DeckJsxIntrinsicElements, ot as DeckPointLength, p as IntrinsicTextTag, pt as Spacing, q as CssGridPlacement, r as ClassNameValue, rn as StyleDiagnosticError, rt as CssPosition, s as DeckOptions, sn as JsxKey, st as ImageCropAuthoring, t as BackendName, tn as DeckDiagnosticError, tt as CssObjectPosition, u as IntrinsicDivProps, ut as LayoutMode, v as SlideProps, vt as StrokeLineJoin, w as CompositionContext, wt as TextTabStopLength, x as TextRunNodeProps, xt as TextStyle, y as TextJsxChild, yt as TextFit, z as CssAspectRatio } from "./index-sb451NVh.mjs";
-import { a as createElement, c as Slide, i as Fragment, l as Text, o as Image, s as Shape, u as View } from "./jsx-runtime-Bk7Wx3AL.mjs";
-import { i as Deck, n as CompileInspectResult, r as CompileMode, t as BoundSource } from "./deck-CvTHG5ik.mjs";
+import { $t as ViewStyle, A as ThemeDefaults, At as CssPosition, Bt as Spacing, C as SlideFactoryInput, Ct as CssGridTemplateAreas, D as SourceContextMapper, Dt as CssJustifySelf, E as SourceContextInput, Et as CssJustifyContent, Ft as ImageCropValue, Gt as StrokeLineJoin, Ht as StackAxis, It as ImageStyle, Jt as TextStyle, Kt as TextFit, L as SemanticAuthorGraph, Lt as LayoutMode, Mt as DeckLength, Nt as DeckPointLength, O as Theme, Ot as CssObjectPosition, Pt as ImageCropAuthoring, Qt as VerticalAlign, Rt as ShapeStyle, S as SlideFactory, St as CssGridTemplate, T as SlideOptions, Tt as CssGridTrack, Ut as StrokeDashType, Vt as StackAlignment, Wt as StrokeLineCap, Xt as TextTabStopAuthoring, Yt as TextTabStopAlignment, Zt as TextTabStopLength, _ as ViewProps, _t as CssFlexWrap, a as DeckJsxIntrinsicElements, an as formatDiagnostics, at as TemplateFrame, b as CompositionSource, bt as CssGridPlacement, c as IntrinsicDivProps, cn as SemanticGraphDiagnosticError, ct as BorderStyle, d as IntrinsicTextTag, dt as CssAlignSelf, en as Diagnostic, et as EmptySlideTemplateSet, f as IntrinsicViewTag, ft as CssAspectRatio, g as TextRunNodeProps, gt as CssFlexDirection, h as TextProps, ht as CssFlexBasis, i as ContentJsxChild, in as formatDiagnostic, it as TemplateAreaRef, j as StyleSheet, jt as CssVisibility, k as ThemeInput, kt as CssOverflow, l as IntrinsicImgProps, ln as StyleDiagnosticError, lt as CssAlignContent, m as TextJsxChild, mn as SourceSpan, mt as CssDisplay, n as ClassNameValue, nn as DiagnosticSeverity, nt as SlideTemplateSet, o as DeckOptions, on as CompositionDiagnosticError, ot as TemplateHandle, p as ShapeProps, pn as JsxKey, pt as CssBoxSizing, qt as TextRunStyle, r as ClassNameValueArray, rn as Diagnostics, rt as TemplateArea, s as ImageProps, sn as DeckDiagnosticError, st as TemplateName, t as ClassNameObject, tn as DiagnosticLabel, tt as SlideTemplate, u as IntrinsicPProps, ut as CssAlignItems, v as COMPOSITION_SOURCE, vt as CssGridAutoFlow, w as SlideFactoryInputWithTemplate, wt as CssGridTemplateShorthand, x as CompositionSourceInternals, xt as CssGridShorthand, y as CompositionContext, yt as CssGridLine, zt as SlideStyle } from "./index-C-LDA3Lj.mjs";
+import { B as StageArtifactStatus, C as ProjectInspectionSummary, E as ResolvedStyleMap, F as OutputFormat, H as StageSummary, I as ProjectStages, L as ProjectionFormat, P as CompileStages, R as RenderStages, U as WrittenOutput, V as StageName, s as PptxPackageModel, z as RenderedArtifact } from "./pptx-DaSXvESd.mjs";
+import { n as WriterAdapter, t as RenderOptions } from "./adapter-NxGlM8_c.mjs";
+import { a as createElement, c as Text, i as Fragment, l as View, o as Image, s as Shape } from "./jsx-runtime-Dz8WBHpq.mjs";
 
+//#region src/pipeline-runner.d.ts
+type CompileResult = {
+  readonly ok: boolean;
+  readonly diagnostics: Diagnostics;
+  readonly stages: CompileStages;
+  readonly graph?: SemanticAuthorGraph;
+  readonly resolvedStyles?: ResolvedStyleMap;
+};
+type ProjectResult = {
+  readonly ok: boolean;
+  readonly diagnostics: Diagnostics;
+  readonly stages: ProjectStages;
+  readonly format: ProjectionFormat;
+  readonly projection?: PptxPackageModel;
+  readonly summary?: ProjectInspectionSummary;
+};
+type RenderResult = {
+  readonly ok: boolean;
+  readonly diagnostics: Diagnostics;
+  readonly stages: RenderStages;
+  readonly format: OutputFormat;
+  readonly artifact?: RenderedArtifact;
+  readonly output?: WrittenOutput;
+};
+//#endregion
+//#region src/deck.d.ts
+type WithSource<TSourceContext, TTemplates extends SlideTemplateSet> = [TSourceContext] extends [void] ? never : (sourceContext: TSourceContext) => BoundSource<TSourceContext, TTemplates>;
+/**
+ * A Deck with Source Context already bound.
+ *
+ * Bound sources can be mounted, compiled, projected, or rendered, but they are not an authoring
+ * registration surface. Use `Deck#withSource(...)` when a child Deck requires Source Context and
+ * should be executed as a standalone source.
+ *
+ * @typeParam TSourceContext - The Source Context type already bound to this source.
+ * @typeParam TTemplates - The Deck-local Slide Template set owned by the source Deck.
+ */
+declare class BoundSource<TSourceContext = void, TTemplates extends SlideTemplateSet = SlideTemplateSet> implements CompositionSource<TSourceContext> {
+  #private;
+  /**
+   * @param source - The Deck whose Source Context should be bound.
+   * @param sourceContext - The Source Context value used whenever this source is composed.
+   */
+  constructor(source: Deck<TSourceContext, TTemplates>, sourceContext: TSourceContext);
+  [COMPOSITION_SOURCE](): CompositionSourceInternals<TSourceContext>;
+  /**
+   * Compile this bound source into a Semantic Author Graph and resolved style inspection data.
+   *
+   * @returns A compile result with diagnostics, stage summaries, and graph artifacts when available.
+   */
+  compile(): CompileResult;
+  /**
+   * Project this bound source into the configured output document model.
+   *
+   * @returns A project result with diagnostics, stage summaries, and the projected model when valid.
+   */
+  project(): ProjectResult;
+  /**
+   * Render this bound source with the default writer adapter or an explicit Writer Adapter.
+   *
+   * @param config - Render options for the default adapter, or an explicit Writer Adapter.
+   * @returns A Promise resolving to render diagnostics, stage summaries, and an artifact when render succeeds.
+   */
+  render(config?: RenderOptions | WriterAdapter<PptxPackageModel>): Promise<RenderResult>;
+}
+type UntemplatedSlideOptions = Omit<SlideOptions<SlideTemplateSet>, "template"> & {
+  readonly template?: never;
+};
+/**
+ * The main authoring object for a deckjsx document.
+ *
+ * A Deck owns slide declarations, source-local stylesheets, optional Theme configuration, and
+ * Deck-local Slide Templates. It compiles JSX authoring into the Semantic Author Graph, projects
+ * that graph into an output document model, and renders the projected model through a writer.
+ *
+ * @typeParam TSourceContext - Source Context required by this Deck's slide factories.
+ * @typeParam TTemplates - Deck-local Slide Template set inferred from `new Deck({ templates })`.
+ */
+declare class Deck<TSourceContext = void, TTemplates extends SlideTemplateSet = EmptySlideTemplateSet> implements CompositionSource<TSourceContext> {
+  #private;
+  /** Bind Source Context to this Deck so it can be compiled, projected, rendered, or mounted. */
+  readonly withSource: WithSource<TSourceContext, TTemplates>;
+  /**
+   * @param options - Deck configuration, including layout, metadata, Theme, output format, and Deck Templates.
+   */
+  constructor(options: DeckOptions<TTemplates>);
+  get options(): DeckOptions<TTemplates>;
+  [COMPOSITION_SOURCE](): CompositionSourceInternals<TSourceContext>;
+  /**
+   * Register a source-local StyleSheet for CSS-like `className` resolution.
+   *
+   * @param stylesheet - The StyleSheet to apply to slides declared by this Deck source.
+   * @returns This Deck, for fluent authoring.
+   */
+  useStyles(stylesheet: StyleSheet): this;
+  /**
+   * Declare one slide.
+   *
+   * The factory returns the slide content JSX directly; authors should not wrap content in a public
+   * `<Slide>` root. Slide-level metadata such as `name`, `className`, `style`, and `template` belongs
+   * in the options object.
+   *
+   * @param factory - Callback that returns the authored JSX content for the slide.
+   * @returns This Deck, for fluent authoring.
+   */
+  slide(factory: SlideFactory<TSourceContext>): this;
+  /**
+   * Declare one untemplated slide with slide-level options.
+   *
+   * Use this overload for slide metadata or slide-level style when no Deck Template is selected.
+   *
+   * @param options - Slide-level metadata and style. `template` is intentionally unavailable here.
+   * @param factory - Callback that returns the authored JSX content for the slide.
+   * @returns This Deck, for fluent authoring.
+   */
+  slide(options: UntemplatedSlideOptions, factory: SlideFactory<TSourceContext>): this;
+  /**
+   * Declare one slide using a Deck-owned Slide Template.
+   *
+   * The selected template name is type-checked from `new Deck({ templates })`. The factory receives a
+   * typed `template` handle whose properties create Template Area References, e.g.
+   * `area={template.title}`.
+   *
+   * @param options - Slide-level options including the selected Deck Template name.
+   * @param factory - Callback that returns authored JSX content and receives a typed `template` handle.
+   * @returns This Deck, for fluent authoring.
+   */
+  slide<TTemplateName extends TemplateName<TTemplates>>(options: SlideOptions<TTemplates, TTemplateName> & {
+    readonly template: TTemplateName;
+  }, factory: SlideFactory<TSourceContext, SlideFactoryInputWithTemplate<TSourceContext, TTemplates, TTemplateName>>): this;
+  /**
+   * Mount another Deck as a child source.
+   *
+   * Child Decks keep their own Source Context, stylesheets, Theme, and Slide Templates. Parent Deck
+   * templates are not inherited by mounted children.
+   *
+   * @param sourceKey - Source-local key used for source identity and diagnostics.
+   * @param child - Child Deck to compose into this Deck.
+   * @param context - Required child Source Context value or synchronous mapper when the child needs context.
+   * @returns This Deck, for fluent authoring.
+   */
+  mount<TChildContext, TChildTemplates extends SlideTemplateSet>(sourceKey: string, child: Deck<TChildContext, TChildTemplates>, ...context: [TChildContext] extends [void] ? [] : [sourceContext: SourceContextInput<TSourceContext, TChildContext>]): this;
+  mount<TChildContext, TChildTemplates extends SlideTemplateSet>(sourceKey: string, child: BoundSource<TChildContext, TChildTemplates>): this;
+  /**
+   * Replace the current compiled graph artifact before calling `project()` or `render()`.
+   *
+   * @param graph - The Semantic Author Graph to use as this Deck's compiled state.
+   * @returns This Deck, for fluent pipeline editing.
+   */
+  defineGraph(graph: SemanticAuthorGraph): this;
+  /**
+   * Replace the current projected document model artifact before calling `render()`.
+   *
+   * @param projection - The projected PPTX Package Model to use as this Deck's projection state.
+   * @returns This Deck, for fluent pipeline editing.
+   */
+  defineProjection(projection: PptxPackageModel): this;
+  /**
+   * Compile this root Deck into the Semantic Author Graph and inspection artifacts.
+   *
+   * @returns A compile result with diagnostics, stage summaries, and graph artifacts when available.
+   */
+  compile(this: Deck<void, TTemplates>): CompileResult;
+  /**
+   * Project this root Deck into the configured output document model.
+   *
+   * @returns A project result with diagnostics, stage summaries, and the projected model when valid.
+   */
+  project(this: Deck<void, TTemplates>): ProjectResult;
+  /**
+   * Render this root Deck with the default writer adapter or an explicit Writer Adapter.
+   *
+   * @param config - Render options for the default adapter, or an explicit Writer Adapter.
+   * @returns A Promise resolving to render diagnostics, stage summaries, and an artifact when render succeeds.
+   */
+  render(this: Deck<void, TTemplates>, config?: RenderOptions | WriterAdapter<PptxPackageModel>): Promise<RenderResult>;
+}
+//#endregion
 //#region src/types.d.ts
 declare const EMU_PER_INCH = 914400;
 declare const POINTS_PER_INCH = 72;
@@ -20,4 +199,4 @@ declare global {
   }
 }
 //#endregion
-export { type BackendName, type BorderStyle, type BoundSource, type ClassNameObject, type ClassNameValue, type ClassNameValueArray, type CompileInspectResult, type CompileMode, type CompositionContext, CompositionDiagnosticError, type ContentJsxChild, type CssAlignContent, type CssAlignItems, type CssAlignSelf, type CssAspectRatio, type CssBoxSizing, type CssDisplay, type CssFlexBasis, type CssFlexDirection, type CssFlexWrap, type CssGridAutoFlow, type CssGridLine, type CssGridPlacement, type CssGridShorthand, type CssGridTemplate, type CssGridTemplateAreas, type CssGridTemplateShorthand, type CssGridTrack, type CssJustifyContent, type CssJustifySelf, type CssObjectPosition, type CssOverflow, type CssPosition, type CssVisibility, Deck, DeckDiagnosticError, type DeckJsxIntrinsicElements, type DeckLength, type DeckOptions, type DeckPointLength, type Diagnostic, type DiagnosticLabel, type DiagnosticSeverity, type Diagnostics, EMU_PER_INCH, Fragment, Image, type ImageCropAuthoring, type ImageCropValue, type ImageProps, type ImageStyle, type ImplementedBackendName, type IntrinsicDivProps, type IntrinsicImgProps, type IntrinsicPProps, type IntrinsicTextTag, type IntrinsicViewTag, type JsxKey, type LayoutMode, type OutputConfig, POINTS_PER_INCH, SemanticGraphDiagnosticError, Shape, type ShapeProps, type ShapeStyle, Slide, type SlideContext, type SlideFactory, type SlideFactoryInput, type SlideProps, type SlideStyle, type SourceContextMapper, type SourceSpan, type Spacing, type StackAlignment, type StackAxis, type StrokeDashType, type StrokeLineCap, type StrokeLineJoin, StyleDiagnosticError, StyleSheet, Text, type TextFit, type TextJsxChild, type TextProps, type TextRunNodeProps, type TextRunStyle, type TextStyle, type TextTabStopAlignment, type TextTabStopAuthoring, type TextTabStopLength, Theme, type ThemeDefaults, type ThemeInput, type VerticalAlign, View, type ViewProps, type ViewStyle, createElement, formatDiagnostic, formatDiagnostics };
+export { type BorderStyle, type BoundSource, type ClassNameObject, type ClassNameValue, type ClassNameValueArray, type CompileResult, type CompositionContext, CompositionDiagnosticError, type ContentJsxChild, type CssAlignContent, type CssAlignItems, type CssAlignSelf, type CssAspectRatio, type CssBoxSizing, type CssDisplay, type CssFlexBasis, type CssFlexDirection, type CssFlexWrap, type CssGridAutoFlow, type CssGridLine, type CssGridPlacement, type CssGridShorthand, type CssGridTemplate, type CssGridTemplateAreas, type CssGridTemplateShorthand, type CssGridTrack, type CssJustifyContent, type CssJustifySelf, type CssObjectPosition, type CssOverflow, type CssPosition, type CssVisibility, Deck, DeckDiagnosticError, type DeckJsxIntrinsicElements, type DeckLength, type DeckOptions, type DeckPointLength, type Diagnostic, type DiagnosticLabel, type DiagnosticSeverity, type Diagnostics, EMU_PER_INCH, Fragment, Image, type ImageCropAuthoring, type ImageCropValue, type ImageProps, type ImageStyle, type IntrinsicDivProps, type IntrinsicImgProps, type IntrinsicPProps, type IntrinsicTextTag, type IntrinsicViewTag, type JsxKey, type LayoutMode, type OutputFormat, POINTS_PER_INCH, type ProjectResult, type ProjectionFormat, type RenderResult, type RenderedArtifact, SemanticGraphDiagnosticError, Shape, type ShapeProps, type ShapeStyle, type SlideFactory, type SlideFactoryInput, type SlideFactoryInputWithTemplate, type SlideOptions, type SlideStyle, type SlideTemplate, type SlideTemplateSet, type SourceContextMapper, type SourceSpan, type Spacing, type StackAlignment, type StackAxis, type StageArtifactStatus, type StageName, type StageSummary, type StrokeDashType, type StrokeLineCap, type StrokeLineJoin, StyleDiagnosticError, StyleSheet, type TemplateArea, type TemplateAreaRef, type TemplateFrame, type TemplateHandle, Text, type TextFit, type TextJsxChild, type TextProps, type TextRunNodeProps, type TextRunStyle, type TextStyle, type TextTabStopAlignment, type TextTabStopAuthoring, type TextTabStopLength, Theme, type ThemeDefaults, type ThemeInput, type VerticalAlign, View, type ViewProps, type ViewStyle, type WrittenOutput, createElement, formatDiagnostic, formatDiagnostics };