deckjsx 0.7.0 → 0.8.0

package/dist/index.d.mts

@@ -1,35 +1,64 @@
-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";
+import { $ as Diagnostics, $t as StackAlignment, At as CssGridAutoFlow, Bt as CssObjectPosition, C as SourceContextValue, Ct as CssAlignSelf, D as StyleSheet, Dt as CssFlexBasis, E as ThemeDefaults, Et as CssDisplay, Ft as CssGridTemplateAreas, Gt as DeckPointLength, Ht as CssPosition, It as CssGridTemplateShorthand, Jt as ImageStyle, Kt as ImageCropAuthoring, Lt as CssGridTrack, Mt as CssGridPlacement, N as SemanticAuthorGraph, Nt as CssGridShorthand, Ot as CssFlexDirection, Pt as CssGridTemplate, Q as DiagnosticSeverity, Qt as Spacing, Rt as CssJustifyContent, S as SourceContextMapper, St as CssAlignItems, T as ThemeInput, Tt as CssBoxSizing, Ut as CssVisibility, Vt as CssOverflow, Wt as DeckLength, X as Diagnostic, Xt as ShapeStyle, Yt as LayoutMode, Z as DiagnosticLabel, Zt as SlideStyle, _ as SlideFactory, _t as TemplateFrame, a as IntrinsicDivProps, at as StyleDiagnosticError, b as SlideOptions, bt as BorderStyle, c as IntrinsicShapeProps, cn as TextStyle, ct as ClassNameObject, dn as TextTabStopLength, dt as EmptySlideTemplateSet, en as StackAxis, et as formatDiagnostic, f as TextJsxChild, fn as VerticalAlign, ft as SlideTemplate, g as CompositionSourceInternals, gt as TemplateAreaRef, h as CompositionSource, ht as TemplateAreaKind, i as DeckOptions, it as SemanticGraphDiagnosticError, jt as CssGridLine, kt as CssFlexWrap, l as IntrinsicTextTag, ln as TextTabStopAlignment, lt as ClassNameValue, m as CompositionContext, mt as TemplateArea, n as DeckJsxElement, nn as StrokeLineCap, nt as CompositionDiagnosticError, o as IntrinsicImgProps, on as TextFit, ot as JsxKey, p as COMPOSITION_SOURCE, pn as ViewStyle, pt as SlideTemplateSet, qt as ImageCropValue, r as DeckJsxIntrinsicElements, rn as StrokeLineJoin, rt as DeckDiagnosticError, s as IntrinsicPProps, sn as TextRunStyle, st as SourceSpan, t as ContentJsxChild, tn as StrokeDashType, tt as formatDiagnostics, u as IntrinsicViewTag, un as TextTabStopAuthoring, ut as ClassNameValueArray, v as SlideFactoryInput, vt as TemplateHandle, w as Theme, wt as CssAspectRatio, x as SourceContextInput, xt as CssAlignContent, y as SlideFactoryInputWithTemplate, yt as TemplateName, zt as CssJustifySelf } from "./index-dx2ZSBgF.mjs";
+import { An as AssetSource, Cn as StageSummary, Dn as AssetLoaderContext, En as AssetLoader, Gt as ProjectInspectionSummary, On as AssetMediaType, Sn as StageName, T as PptxPackageModelCandidate, Tn as AssetLoadResult, _n as RenderOutputSideEffectStatus, an as ProjectOptions, bn as RenderedArtifact, cn as RenderAssemblyBuildSummary, dn as RenderAssemblyFingerprintDelta, fn as RenderAssemblyPlanEntrySummary, gn as RenderOutputSideEffectReason, hn as RenderInspectionSummary, in as OutputFormat, kn as AssetProbeResult, ln as RenderAssemblyExpectedEntrySummary, mn as RenderAssemblyReasonDetails, nn as CompileStages, on as ProjectStages, pn as RenderAssemblyPlanSummary, rn as InspectionDetailLevel, sn as ProjectionFormat, un as RenderAssemblyFinalEntrySummary, vn as RenderOutputSideEffectSummary, w as PptxPackageModel, wn as WrittenOutput, xn as StageArtifactStatus, yn as RenderStages } from "./model-BVkO8qGK.mjs";
+import { n as RenderOptions, r as WriterAdapter } from "./adapter-C2AHiDGa.mjs";
+import { r as ResolvedStyleMap } from "./resolve-BD1dHxZd.mjs";
 
 //#region src/pipeline-runner.d.ts
-type CompileResult = {
+type PresentStageArtifactStatus = Exclude<StageArtifactStatus, "missing">;
+type CompileResult = CompileResultWithGraph | CompileResultWithoutGraph;
+type CompileResultWithGraph = {
   readonly ok: boolean;
   readonly diagnostics: Diagnostics;
-  readonly stages: CompileStages;
-  readonly graph?: SemanticAuthorGraph;
-  readonly resolvedStyles?: ResolvedStyleMap;
+  readonly stages: CompileStages<PresentStageArtifactStatus>;
+  readonly graph: SemanticAuthorGraph;
+  readonly resolvedStyles: ResolvedStyleMap;
 };
-type ProjectResult = {
+type CompileResultWithoutGraph = {
   readonly ok: boolean;
   readonly diagnostics: Diagnostics;
-  readonly stages: ProjectStages;
+  readonly stages: CompileStages<"missing">;
+  readonly graph?: undefined;
+  readonly resolvedStyles?: undefined;
+};
+type ProjectResult = ProjectResultWithProjection | ProjectResultWithoutProjection;
+type ProjectResultWithProjection = {
+  readonly ok: boolean;
+  readonly diagnostics: Diagnostics;
+  readonly stages: ProjectStages<StageArtifactStatus, PresentStageArtifactStatus>;
   readonly format: ProjectionFormat;
-  readonly projection?: PptxPackageModel;
+  readonly projection: PptxPackageModel;
   readonly summary?: ProjectInspectionSummary;
 };
-type RenderResult = {
+type ProjectResultWithoutProjection = {
   readonly ok: boolean;
   readonly diagnostics: Diagnostics;
-  readonly stages: RenderStages;
+  readonly stages: ProjectStages<StageArtifactStatus, "missing">;
+  readonly format: ProjectionFormat;
+  readonly projection?: undefined;
+  readonly summary?: undefined;
+};
+type RenderResult = RenderResultWithArtifact | RenderResultWithoutArtifact;
+type RenderResultWithArtifact = {
+  readonly ok: boolean;
+  readonly diagnostics: Diagnostics;
+  readonly stages: RenderStages<StageArtifactStatus, StageArtifactStatus, PresentStageArtifactStatus>;
   readonly format: OutputFormat;
-  readonly artifact?: RenderedArtifact;
+  readonly artifact: RenderedArtifact;
   readonly output?: WrittenOutput;
+  readonly summary?: RenderInspectionSummary;
+};
+type RenderResultWithoutArtifact = {
+  readonly ok: boolean;
+  readonly diagnostics: Diagnostics;
+  readonly stages: RenderStages<StageArtifactStatus, StageArtifactStatus, "missing">;
+  readonly format: OutputFormat;
+  readonly artifact?: undefined;
+  readonly output?: undefined;
+  readonly summary?: undefined;
 };
 //#endregion
 //#region src/deck.d.ts
-type WithSource<TSourceContext, TTemplates extends SlideTemplateSet> = [TSourceContext] extends [void] ? never : (sourceContext: TSourceContext) => BoundSource<TSourceContext, TTemplates>;
+type WithSource<TSourceContext extends SourceContextValue | void, TTemplates extends SlideTemplateSet> = [TSourceContext] extends [void] ? never : (sourceContext: TSourceContext) => BoundSource<TSourceContext, TTemplates>;
 /**
  * A Deck with Source Context already bound.
  *
@@ -40,14 +69,14 @@ type WithSource<TSourceContext, TTemplates extends SlideTemplateSet> = [TSourceC
  * @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> {
+declare class BoundSource<TSourceContext extends SourceContextValue | void = void, TTemplates extends SlideTemplateSet = SlideTemplateSet> implements CompositionSource<TSourceContext, TTemplates> {
   #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>;
+  [COMPOSITION_SOURCE](): CompositionSourceInternals<TSourceContext, TTemplates>;
   /**
    * Compile this bound source into a Semantic Author Graph and resolved style inspection data.
    *
@@ -59,7 +88,7 @@ declare class BoundSource<TSourceContext = void, TTemplates extends SlideTemplat
    *
    * @returns A project result with diagnostics, stage summaries, and the projected model when valid.
    */
-  project(): ProjectResult;
+  project(options?: ProjectOptions): Promise<ProjectResult>;
   /**
    * Render this bound source with the default writer adapter or an explicit Writer Adapter.
    *
@@ -81,7 +110,7 @@ type UntemplatedSlideOptions = Omit<SlideOptions<SlideTemplateSet>, "template">
  * @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> {
+declare class Deck<TSourceContext extends SourceContextValue | void = void, TTemplates extends SlideTemplateSet = EmptySlideTemplateSet> implements CompositionSource<TSourceContext, TTemplates> {
   #private;
   /** Bind Source Context to this Deck so it can be compiled, projected, rendered, or mounted. */
   readonly withSource: WithSource<TSourceContext, TTemplates>;
@@ -90,7 +119,8 @@ declare class Deck<TSourceContext = void, TTemplates extends SlideTemplateSet =
    */
   constructor(options: DeckOptions<TTemplates>);
   get options(): DeckOptions<TTemplates>;
-  [COMPOSITION_SOURCE](): CompositionSourceInternals<TSourceContext>;
+  get assetLoaders(): readonly AssetLoader[];
+  [COMPOSITION_SOURCE](): CompositionSourceInternals<TSourceContext, TTemplates>;
   /**
    * Register a source-local StyleSheet for CSS-like `className` resolution.
    *
@@ -98,6 +128,20 @@ declare class Deck<TSourceContext = void, TTemplates extends SlideTemplateSet =
    * @returns This Deck, for fluent authoring.
    */
   useStyles(stylesheet: StyleSheet): this;
+  /**
+   * Register a source-local Asset Loading Boundary for media metadata and bytes.
+   *
+   * Asset loaders keep runtime-specific filesystem, framework-public URL, or authenticated media
+   * rules outside the multi-runtime core. Project and Render consume the registered loaders when
+   * media metadata or bytes are required.
+   *
+   * Loaders are evaluated before deckjsx's built-in asset boundary and in registration order. The
+   * loader that resolves Project metadata also owns Render byte loading for that source.
+   *
+   * @param loader - Asset loader with optional probe/load functions.
+   * @returns This Deck, for fluent authoring.
+   */
+  useAssets(loader: AssetLoader): this;
   /**
    * Declare one slide.
    *
@@ -144,8 +188,8 @@ declare class Deck<TSourceContext = void, TTemplates extends SlideTemplateSet =
    * @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;
+  mount<TChildContext extends SourceContextValue | void, TChildTemplates extends SlideTemplateSet>(sourceKey: string, child: Deck<TChildContext, TChildTemplates>, ...context: [TChildContext] extends [void] ? [] : [sourceContext: SourceContextInput<TSourceContext, TChildContext>]): this;
+  mount<TChildContext extends SourceContextValue | void, TChildTemplates extends SlideTemplateSet>(sourceKey: string, child: BoundSource<TChildContext, TChildTemplates>): this;
   /**
    * Replace the current compiled graph artifact before calling `project()` or `render()`.
    *
@@ -159,7 +203,7 @@ declare class Deck<TSourceContext = void, TTemplates extends SlideTemplateSet =
    * @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;
+  defineProjection(projection: PptxPackageModelCandidate): this;
   /**
    * Compile this root Deck into the Semantic Author Graph and inspection artifacts.
    *
@@ -171,7 +215,7 @@ declare class Deck<TSourceContext = void, TTemplates extends SlideTemplateSet =
    *
    * @returns A project result with diagnostics, stage summaries, and the projected model when valid.
    */
-  project(this: Deck<void, TTemplates>): ProjectResult;
+  project(this: Deck<void, TTemplates>, options?: ProjectOptions): Promise<ProjectResult>;
   /**
    * Render this root Deck with the default writer adapter or an explicit Writer Adapter.
    *
@@ -199,4 +243,4 @@ declare global {
   }
 }
 //#endregion
-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 };
+export { type AssetLoadResult, type AssetLoader, type AssetLoaderContext, type AssetMediaType, type AssetProbeResult, type AssetSource, 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 DeckJsxElement, type DeckJsxIntrinsicElements, type DeckLength, type DeckOptions, type DeckPointLength, type Diagnostic, type DiagnosticLabel, type DiagnosticSeverity, type Diagnostics, EMU_PER_INCH, type ImageCropAuthoring, type ImageCropValue, type ImageStyle, type InspectionDetailLevel, type IntrinsicDivProps, type IntrinsicImgProps, type IntrinsicPProps, type IntrinsicShapeProps, type IntrinsicTextTag, type IntrinsicViewTag, type JsxKey, type LayoutMode, type OutputFormat, POINTS_PER_INCH, type ProjectOptions, type ProjectResult, type ProjectionFormat, type RenderAssemblyBuildSummary, type RenderAssemblyExpectedEntrySummary, type RenderAssemblyFinalEntrySummary, type RenderAssemblyFingerprintDelta, type RenderAssemblyPlanEntrySummary, type RenderAssemblyPlanSummary, type RenderAssemblyReasonDetails, type RenderInspectionSummary, type RenderOutputSideEffectReason, type RenderOutputSideEffectStatus, type RenderOutputSideEffectSummary, type RenderResult, type RenderedArtifact, SemanticGraphDiagnosticError, 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 TemplateAreaKind, type TemplateAreaRef, type TemplateFrame, type TemplateHandle, type TextFit, type TextJsxChild, type TextRunStyle, type TextStyle, type TextTabStopAlignment, type TextTabStopAuthoring, type TextTabStopLength, Theme, type ThemeDefaults, type ThemeInput, type VerticalAlign, type ViewStyle, type WrittenOutput, formatDiagnostic, formatDiagnostics };