deckjsx 0.6.0 → 0.8.0

package/dist/{index-C5l8PX5V.d.mts → index-dx2ZSBgF.d.mts}

@@ -1,213 +1,6 @@
 //#region src/authoring/tags.d.ts
-type AuthoredTag = "article" | "aside" | "div" | "figure" | "footer" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "img" | "main" | "nav" | "p" | "section" | "span";
+type AuthoredTag = "article" | "aside" | "div" | "figure" | "footer" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "header" | "img" | "main" | "nav" | "p" | "section" | "shape" | "span";
 type SectioningTag = "article" | "aside" | "footer" | "header" | "main" | "nav" | "section";
-type AuthoredComponent = "Image" | "Shape" | "Slide" | "Text" | "View";
-type IntrinsicViewTag$1 = "article" | "aside" | "div" | "figure" | "footer" | "header" | "main" | "nav" | "section";
-type IntrinsicTextTag$1 = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p";
-//#endregion
-//#region src/authoring/tree.d.ts
-type JsxKey = string | number | bigint;
-type SourceSpan = {
-  readonly file?: string;
-  readonly line?: number;
-  readonly column?: number;
-};
-type AuthorElementSource = {
-  readonly kind: "tag";
-  readonly tag: AuthoredTag;
-} | {
-  readonly kind: "component";
-  readonly component: AuthoredComponent;
-};
-type AuthorElementNode = {
-  readonly $$typeof: "deckjsx.author-tree";
-  readonly kind: "element";
-  readonly source: AuthorElementSource;
-  readonly key?: JsxKey;
-  readonly props: Record<string, unknown>;
-  readonly children: readonly AuthorTreeNode[];
-  readonly sourceSpan?: SourceSpan;
-};
-type AuthorFragmentNode = {
-  readonly $$typeof: "deckjsx.author-tree";
-  readonly kind: "fragment";
-  readonly key?: JsxKey;
-  readonly children: readonly AuthorTreeNode[];
-  readonly sourceSpan?: SourceSpan;
-};
-type AuthorTextLeaf = {
-  readonly $$typeof: "deckjsx.author-tree";
-  readonly kind: "text";
-  readonly value: string | number;
-  readonly sourceSpan?: SourceSpan;
-};
-type AuthorTreeNode = AuthorElementNode | AuthorFragmentNode | AuthorTextLeaf;
-type AuthorTreeChild = AuthorTreeNode | string | number | boolean | null | undefined | readonly AuthorTreeChild[];
-//#endregion
-//#region src/diagnostics/errors.d.ts
-declare class DeckDiagnosticError extends Error {
-  readonly diagnostics: Diagnostics;
-  constructor(message: string, diagnostics: Diagnostics);
-}
-declare class SemanticGraphDiagnosticError extends DeckDiagnosticError {
-  constructor(diagnostics: Diagnostics);
-}
-declare class CompositionDiagnosticError extends DeckDiagnosticError {
-  constructor(diagnostics: Diagnostics);
-}
-declare class StyleDiagnosticError extends DeckDiagnosticError {
-  constructor(diagnostics: Diagnostics);
-}
-//#endregion
-//#region src/diagnostics/format.d.ts
-declare function formatDiagnostic(diagnostic: Diagnostic): string;
-declare function formatDiagnostics(diagnostics: Diagnostics): string;
-//#endregion
-//#region src/diagnostics/index.d.ts
-type DiagnosticSeverity = "error" | "warning";
-type DiagnosticLabel = {
-  readonly message: string;
-  readonly path: string;
-  readonly sourceSpan?: SourceSpan;
-  readonly severity?: "primary" | "secondary";
-};
-type Diagnostic = {
-  readonly severity: DiagnosticSeverity;
-  readonly code: string;
-  readonly title: string;
-  readonly message?: string;
-  readonly labels: readonly DiagnosticLabel[];
-  readonly notes?: readonly string[];
-  readonly help?: readonly string[];
-};
-type Diagnostics = {
-  readonly items: readonly Diagnostic[];
-  readonly hasErrors: boolean;
-  readonly hasWarnings: boolean;
-};
-//#endregion
-//#region src/graph/types.d.ts
-type Brand<T, B extends string> = T & {
-  readonly __brand: B;
-};
-type GraphNodeId = Brand<string, "GraphNodeId">;
-type StyleEntityId = Brand<string, "StyleEntityId">;
-type AssetEntityId = Brand<string, "AssetEntityId">;
-type SourceIdentity = Brand<string, "SourceIdentity">;
-type SemanticNodeKind = "container" | "document" | "image" | "shape" | "slide" | "text" | "textRun";
-type SemanticRole = {
-  readonly kind: "document";
-} | {
-  readonly kind: "slide";
-} | {
-  readonly kind: "genericContainer";
-} | {
-  readonly kind: "sectioning";
-  readonly tag: SectioningTag;
-} | {
-  readonly kind: "figure";
-} | {
-  readonly kind: "paragraph";
-} | {
-  readonly kind: "heading";
-  readonly level: 1 | 2 | 3 | 4 | 5 | 6;
-} | {
-  readonly kind: "image";
-} | {
-  readonly kind: "shape";
-};
-type SourceOrigin = {
-  readonly kind: "root";
-} | {
-  readonly kind: "mounted";
-  readonly sourceKey: string;
-  readonly sourceIdentity: SourceIdentity;
-};
-type SemanticOrigin = {
-  readonly kind: "authored" | "implicit";
-  readonly path: string;
-  readonly source?: SourceOrigin;
-  readonly sourceSpan?: SourceSpan;
-  readonly reason?: "primitive-text-in-container";
-};
-type BaseSemanticNode = {
-  readonly id: GraphNodeId;
-  readonly kind: SemanticNodeKind;
-  readonly origin: SemanticOrigin;
-  readonly authoredTag?: AuthoredTag;
-  readonly authoredComponent?: AuthoredComponent;
-  readonly role?: SemanticRole;
-  readonly key?: JsxKey;
-  readonly styleRef?: StyleEntityId;
-};
-type SemanticDocumentNode = BaseSemanticNode & {
-  readonly kind: "document";
-  readonly children: readonly GraphNodeId[];
-};
-type SemanticSlideNode = BaseSemanticNode & {
-  readonly kind: "slide";
-  readonly name?: string;
-  readonly children: readonly GraphNodeId[];
-};
-type SemanticContainerNode = BaseSemanticNode & {
-  readonly kind: "container";
-  readonly children: readonly GraphNodeId[];
-};
-type SemanticTextNode = BaseSemanticNode & {
-  readonly kind: "text";
-  readonly inlineChildren: readonly GraphNodeId[];
-  readonly implicit?: boolean;
-};
-type SemanticTextRunNode = BaseSemanticNode & {
-  readonly kind: "textRun";
-  readonly text: string;
-};
-type SemanticImageNode = BaseSemanticNode & {
-  readonly kind: "image";
-  readonly assetRef?: AssetEntityId;
-};
-type SemanticShapeNode = BaseSemanticNode & {
-  readonly kind: "shape";
-  readonly shape: "rect" | "ellipse" | "line";
-};
-type SemanticNode = SemanticContainerNode | SemanticDocumentNode | SemanticImageNode | SemanticShapeNode | SemanticSlideNode | SemanticTextNode | SemanticTextRunNode;
-type StyleClassRef = {
-  readonly name: string;
-  readonly index: number;
-};
-type StyleEntity = {
-  readonly id: StyleEntityId;
-  readonly target: SemanticNodeKind;
-  readonly authored: {
-    readonly style?: unknown;
-    readonly classRefs?: readonly StyleClassRef[];
-  };
-};
-type AssetEntity = {
-  readonly id: AssetEntityId;
-  readonly kind: "image";
-  readonly source: {
-    readonly kind: "path";
-    readonly path: string;
-  } | {
-    readonly kind: "data";
-    readonly data: string;
-  };
-  readonly metadata: {
-    readonly mediaType?: string;
-    readonly byteLength?: number;
-    readonly widthPx?: number;
-    readonly heightPx?: number;
-    readonly contentHash?: string;
-  };
-  readonly resolution: "failed" | "resolved" | "unresolved";
-};
-type SemanticAuthorGraph = {
-  readonly documentId: GraphNodeId;
-  readonly nodes: ReadonlyMap<GraphNodeId, SemanticNode>;
-  readonly styles: ReadonlyMap<StyleEntityId, StyleEntity>;
-  readonly assets: ReadonlyMap<AssetEntityId, AssetEntity>;
-};
 //#endregion
 //#region src/style/types.d.ts
 type DeckLength = number | `${number}${"in" | "pt" | "px" | "%" | "em" | "rem" | "vh" | "vw" | "ch"}`;
@@ -263,6 +56,9 @@ type BaseAuthorProps = {
   rotation?: number;
   transform?: string;
   transformOrigin?: string;
+  filter?: string;
+  mixBlendMode?: string;
+  isolation?: "auto" | "isolate";
   zIndex?: number;
   flipH?: boolean;
   flipV?: boolean;
@@ -462,8 +258,286 @@ type ShapeStyle = FrameAuthorProps & Omit<BoxStyleAuthorProps, "backgroundColor"
   radius?: DeckLength;
 };
 type TextRunStyle = Pick<TextStyle, "fontFamily" | "fontSize" | "fontWeight" | "italic" | "fontStyle" | "underline" | "strike" | "textDecoration" | "textDecorationLine" | "textDecorationStyle" | "textDecorationColor" | "textTransform" | "direction" | "writingMode" | "color" | "verticalAlign" | "charSpacing" | "letterSpacing" | "href" | "tooltip" | "superscript" | "subscript" | "textShadow">;
+type KnownStyleDeclarationSource = SlideStyle | ViewStyle | TextStyle | TextRunStyle | ImageStyle | ShapeStyle;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+type ValueOfUnion<T, TKey extends PropertyKey> = T extends T ? TKey extends keyof T ? T[TKey] : never : never;
+type KnownStyleDeclarationKey = KeysOfUnion<KnownStyleDeclarationSource>;
+type StyleDeclarationValue = ValueOfUnion<KnownStyleDeclarationSource, KnownStyleDeclarationKey>;
+type StyleDeclaration = { readonly [Key in KnownStyleDeclarationKey]?: ValueOfUnion<KnownStyleDeclarationSource, Key> };
 type StyleForAuthoredTag<TTag extends string> = TTag extends "span" ? TextRunStyle : TTag extends "img" ? ImageStyle : TTag extends "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p" ? TextStyle : ViewStyle;
 //#endregion
+//#region src/templates.d.ts
+declare const TEMPLATE_AREA_KINDS: readonly ["body", "date", "footer", "generic", "picture", "slideNumber", "title"];
+type TemplateAreaKind = (typeof TEMPLATE_AREA_KINDS)[number];
+/** The concrete frame used by a Template Area before output projection. */
+type TemplateFrame = {
+  readonly x: DeckLength;
+  readonly y: DeckLength;
+  readonly width: DeckLength;
+  readonly height: DeckLength;
+};
+/** A named placement area inside a Slide Template. */
+type TemplateArea = {
+  readonly frame: TemplateFrame;
+  readonly kind?: TemplateAreaKind;
+};
+/** A reusable Deck-owned slide structure made of named Template Areas. */
+type SlideTemplate = {
+  readonly areas: Readonly<Record<string, TemplateArea>>;
+};
+/** The Deck-local set of Slide Templates available to `deck.slide({ template })`. */
+type SlideTemplateSet = Readonly<Record<string, SlideTemplate>>;
+type EmptySlideTemplateSet = Record<never, never>;
+/**
+ * A branded authored reference from slide content to one Template Area.
+ *
+ * Authors normally obtain this value from the slide factory's `template` handle, for example
+ * `area={template.title}`. The runtime reference object is library-owned so callers do not have to
+ * manufacture branded values.
+ *
+ * @typeParam TTemplateName - Name of the Slide Template that owns the referenced area.
+ * @typeParam TAreaName - Name of the referenced Template Area.
+ */
+type TemplateAreaRef<TTemplateName extends string = string, TAreaName extends string = string> = Readonly<{
+  readonly type: "deckjsx.templateAreaRef";
+  readonly template: TTemplateName;
+  readonly area: TAreaName;
+}> & {
+  readonly __deckjsxTemplateAreaRefBrand?: never;
+};
+type TemplateAreaNames<TTemplates extends SlideTemplateSet, TName extends keyof TTemplates> = keyof TTemplates[TName]["areas"] & string;
+/**
+ * The typed template handle passed to a templated slide factory.
+ *
+ * `$name` is a discriminant for template-name unions. Every other key maps to a Template Area
+ * Reference for that area.
+ *
+ * @typeParam TTemplates - Deck-local Slide Template set.
+ * @typeParam TName - Selected Slide Template name.
+ */
+type TemplateHandle<TTemplates extends SlideTemplateSet, TName extends keyof TTemplates & string> = TName extends keyof TTemplates & string ? {
+  readonly $name: TName;
+} & { readonly [AreaName in TemplateAreaNames<TTemplates, TName>]: TemplateAreaRef<TName, AreaName> } : never;
+type TemplateName<TTemplates extends SlideTemplateSet> = keyof TTemplates & string;
+//#endregion
+//#region src/authoring/props.d.ts
+interface ClassNameValueArray extends ReadonlyArray<ClassNameValue> {}
+type ClassNameObject = Readonly<Record<string, boolean | null | undefined>>;
+type ClassNameValue = string | false | null | undefined | ClassNameValueArray | ClassNameObject;
+type ClassNameAuthorProps = {
+  className?: ClassNameValue;
+};
+type TemplateAreaAuthorProps = {
+  area?: TemplateAreaRef;
+};
+type ViewNodeProps = {
+  style?: ViewStyle;
+} & ClassNameAuthorProps & TemplateAreaAuthorProps & ViewStyle;
+type TextNodeProps = {
+  style?: TextStyle;
+} & ClassNameAuthorProps & TemplateAreaAuthorProps & TextStyle;
+type TextRunNodeProps = {
+  style?: TextRunStyle;
+} & ClassNameAuthorProps & TextRunStyle;
+type ImageNodeProps = {
+  style?: ImageStyle;
+} & ClassNameAuthorProps & TemplateAreaAuthorProps & ImageStyle & ({
+  src: string;
+  data?: string;
+} | {
+  src?: string;
+  data: string;
+});
+type ShapeNodeProps = {
+  style?: ShapeStyle;
+  shape: "rect" | "ellipse" | "line";
+} & ClassNameAuthorProps & TemplateAreaAuthorProps & ShapeStyle;
+//#endregion
+//#region src/authoring/tree.d.ts
+type JsxKey = string | number | bigint;
+type SourceSpan = {
+  readonly file?: string;
+  readonly line?: number;
+  readonly column?: number;
+};
+//#endregion
+//#region src/diagnostics/errors.d.ts
+declare class DeckDiagnosticError extends Error {
+  readonly diagnostics: Diagnostics;
+  constructor(message: string, diagnostics: Diagnostics);
+}
+declare class SemanticGraphDiagnosticError extends DeckDiagnosticError {
+  constructor(diagnostics: Diagnostics);
+}
+declare class CompositionDiagnosticError extends DeckDiagnosticError {
+  constructor(diagnostics: Diagnostics);
+}
+declare class StyleDiagnosticError extends DeckDiagnosticError {
+  constructor(diagnostics: Diagnostics);
+}
+//#endregion
+//#region src/diagnostics/format.d.ts
+declare function formatDiagnostic(diagnostic: Diagnostic): string;
+declare function formatDiagnostics(diagnostics: Diagnostics): string;
+//#endregion
+//#region src/diagnostics/index.d.ts
+type DiagnosticSeverity = "error" | "warning";
+type DiagnosticLabel = {
+  readonly message: string;
+  readonly path: string;
+  readonly sourceSpan?: SourceSpan;
+  readonly severity?: "primary" | "secondary";
+};
+type Diagnostic = {
+  readonly severity: DiagnosticSeverity;
+  readonly code: string;
+  readonly title: string;
+  readonly message?: string;
+  readonly labels: readonly DiagnosticLabel[];
+  readonly notes?: readonly string[];
+  readonly help?: readonly string[];
+};
+type Diagnostics = {
+  readonly items: readonly Diagnostic[];
+  readonly hasErrors: boolean;
+  readonly hasWarnings: boolean;
+};
+//#endregion
+//#region src/graph/types.d.ts
+type Brand<T, B extends string> = T & {
+  readonly __brand: B;
+};
+type GraphNodeId = Brand<string, "GraphNodeId">;
+type StyleEntityId = Brand<string, "StyleEntityId">;
+type AssetEntityId = Brand<string, "AssetEntityId">;
+type SourceIdentity = Brand<string, "SourceIdentity">;
+type SemanticNodeKind = "container" | "document" | "image" | "shape" | "slide" | "text" | "textRun";
+type SemanticRole = {
+  readonly kind: "document";
+} | {
+  readonly kind: "slide";
+} | {
+  readonly kind: "genericContainer";
+} | {
+  readonly kind: "sectioning";
+  readonly tag: SectioningTag;
+} | {
+  readonly kind: "figure";
+} | {
+  readonly kind: "paragraph";
+} | {
+  readonly kind: "heading";
+  readonly level: 1 | 2 | 3 | 4 | 5 | 6;
+} | {
+  readonly kind: "image";
+} | {
+  readonly kind: "shape";
+};
+type SourceOrigin = {
+  readonly kind: "root";
+} | {
+  readonly kind: "mounted";
+  readonly sourceKey: string;
+  readonly sourceIdentity: SourceIdentity;
+};
+type SemanticOrigin = {
+  readonly kind: "authored" | "implicit";
+  readonly path: string;
+  readonly source?: SourceOrigin;
+  readonly sourceSpan?: SourceSpan;
+  readonly reason?: "primitive-text-in-container";
+};
+type SemanticTemplateRef = {
+  readonly name: string;
+};
+type SemanticTemplateAreaRef = {
+  readonly template: string;
+  readonly area: string;
+};
+type BaseSemanticNode = {
+  readonly id: GraphNodeId;
+  readonly kind: SemanticNodeKind;
+  readonly origin: SemanticOrigin;
+  readonly authoredTag?: AuthoredTag;
+  readonly role?: SemanticRole;
+  readonly key?: JsxKey;
+  readonly styleRef?: StyleEntityId;
+  readonly templateAreaRef?: SemanticTemplateAreaRef;
+};
+type SemanticDocumentNode = BaseSemanticNode & {
+  readonly kind: "document";
+  readonly children: readonly GraphNodeId[];
+};
+type SemanticSlideNode = BaseSemanticNode & {
+  readonly kind: "slide";
+  readonly name?: string;
+  readonly templateRef?: SemanticTemplateRef;
+  readonly children: readonly GraphNodeId[];
+};
+type SemanticContainerNode = BaseSemanticNode & {
+  readonly kind: "container";
+  readonly children: readonly GraphNodeId[];
+};
+type SemanticTextNode = BaseSemanticNode & {
+  readonly kind: "text";
+  readonly inlineChildren: readonly GraphNodeId[];
+  readonly implicit?: boolean;
+};
+type SemanticTextRunNode = BaseSemanticNode & {
+  readonly kind: "textRun";
+  readonly text: string;
+};
+type SemanticImageNode = BaseSemanticNode & {
+  readonly kind: "image";
+  readonly assetRef?: AssetEntityId;
+};
+type SemanticShapeNode = BaseSemanticNode & {
+  readonly kind: "shape";
+  readonly shape: "rect" | "ellipse" | "line";
+};
+type SemanticNode = SemanticContainerNode | SemanticDocumentNode | SemanticImageNode | SemanticShapeNode | SemanticSlideNode | SemanticTextNode | SemanticTextRunNode;
+type StyleClassRef = {
+  readonly name: string;
+  readonly index: number;
+};
+type StyleEntity = {
+  readonly id: StyleEntityId;
+  readonly target: SemanticNodeKind;
+  readonly authored: {
+    readonly style?: StyleDeclaration;
+    readonly classRefs?: readonly StyleClassRef[];
+  };
+};
+type AssetEntity = {
+  readonly id: AssetEntityId;
+  readonly kind: "image";
+  readonly source: {
+    readonly kind: "path";
+    readonly path: string;
+  } | {
+    readonly kind: "data";
+    readonly data: string;
+  } | {
+    readonly kind: "url";
+    readonly url: string;
+  };
+  readonly metadata: {
+    readonly mediaType?: string;
+    readonly byteLength?: number;
+    readonly widthPx?: number;
+    readonly heightPx?: number;
+    readonly contentHash?: string;
+  };
+  readonly resolution: "failed" | "resolved" | "unresolved";
+};
+type SemanticAuthorGraph = {
+  readonly documentId: GraphNodeId;
+  readonly nodes: ReadonlyMap<GraphNodeId, SemanticNode>;
+  readonly styles: ReadonlyMap<StyleEntityId, StyleEntity>;
+  readonly assets: ReadonlyMap<AssetEntityId, AssetEntity>;
+  readonly templates: ReadonlyMap<string, SlideTemplateSet>;
+};
+//#endregion
 //#region src/style/stylesheet.d.ts
 type StyleTargetSelector = string;
 type StyleClassStyle = SlideStyle | ViewStyle | TextStyle | TextRunStyle | ImageStyle | ShapeStyle;
@@ -472,7 +546,7 @@ type TargetedStyleClassDefinition<TStyle extends StyleClassStyle = StyleClassSty
   readonly style: TStyle;
 };
 type StyleClassDefinition<TStyle extends StyleClassStyle = StyleClassStyle> = TStyle | TargetedStyleClassDefinition<TStyle>;
-type StyleSheetInput<TClasses extends Readonly<Record<string, unknown>> = Readonly<Record<string, StyleClassDefinition>>> = {
+type StyleSheetInput<TClasses extends Readonly<Record<string, StyleClassDefinition>> = Readonly<Record<string, StyleClassDefinition>>> = {
   readonly classes: StyleSheetClasses<TClasses>;
 };
 type RightmostSelectorPart<TSelector extends string> = TSelector extends `${string} ${infer TRight}` ? RightmostSelectorPart<TRight> : TSelector;
@@ -485,14 +559,14 @@ type StyleClassDefinitionFor<TDefinition> = TDefinition extends {
 } ? TTarget extends StyleTargetSelector | readonly StyleTargetSelector[] ? TStyle extends StyleForStyleTarget<TTarget> ? TDefinition : never : never : TDefinition extends {
   readonly style: infer TStyle;
 } ? TStyle extends StyleClassStyle ? TDefinition : never : TDefinition extends StyleClassStyle ? TDefinition : never;
-type StyleSheetClasses<TClasses extends Readonly<Record<string, unknown>>> = { readonly [ClassName in keyof TClasses]: StyleClassDefinitionFor<TClasses[ClassName]> };
-declare class StyleSheetImpl<TClasses extends Readonly<Record<string, unknown>> = Readonly<Record<string, StyleClassDefinition>>> {
+type StyleSheetClasses<TClasses extends Readonly<Record<string, StyleClassDefinition>>> = { readonly [ClassName in keyof TClasses]: StyleClassDefinitionFor<TClasses[ClassName]> };
+declare class StyleSheetImpl<TClasses extends Readonly<Record<string, StyleClassDefinition>> = Readonly<Record<string, StyleClassDefinition>>> {
   readonly classes: StyleSheetClasses<TClasses>;
   constructor(input: StyleSheetInput<TClasses>);
 }
-type StyleSheet<TClasses extends Readonly<Record<string, unknown>> = Readonly<Record<string, StyleClassDefinition>>> = StyleSheetImpl<TClasses>;
+type StyleSheet<TClasses extends Readonly<Record<string, StyleClassDefinition>> = Readonly<Record<string, StyleClassDefinition>>> = StyleSheetImpl<TClasses>;
 declare const StyleSheet: {
-  new <const TClasses extends Readonly<Record<string, unknown>> = Readonly<Record<string, StyleClassDefinition>>>(input: StyleSheetInput<TClasses>): StyleSheet<TClasses>;
+  new <const TClasses extends Readonly<Record<string, StyleClassDefinition>> = Readonly<Record<string, StyleClassDefinition>>>(input: StyleSheetInput<TClasses>): StyleSheet<TClasses>;
 };
 //#endregion
 //#region src/style/defaults.d.ts
@@ -500,7 +574,7 @@ type ThemeDefaults = Partial<{ readonly [Tag in AuthoredTag]: StyleForAuthoredTa
 //#endregion
 //#region src/style/theme-values.d.ts
 type Primitive = string | number | boolean | bigint | symbol | null | undefined;
-type DeepMerge<TBase, TExtension> = TExtension extends readonly unknown[] ? TExtension : TBase extends readonly unknown[] ? TExtension : TBase extends Primitive ? TExtension : TExtension extends Primitive ? TExtension : TBase extends object ? TExtension extends object ? { readonly [Key in keyof TBase | keyof TExtension]: Key extends keyof TExtension ? Key extends keyof TBase ? DeepMerge<TBase[Key], TExtension[Key]> : TExtension[Key] : Key extends keyof TBase ? TBase[Key] : never } : TExtension : TExtension;
+type DeepMerge<TBase, TExtension> = TExtension extends readonly (infer _ExtensionItem)[] ? TExtension : TBase extends readonly (infer _BaseItem)[] ? TExtension : TBase extends Primitive ? TExtension : TExtension extends Primitive ? TExtension : TBase extends object ? TExtension extends object ? { readonly [Key in keyof TBase | keyof TExtension]: Key extends keyof TExtension ? Key extends keyof TBase ? DeepMerge<TBase[Key], TExtension[Key]> : TExtension[Key] : Key extends keyof TBase ? TBase[Key] : never } : TExtension : TExtension;
 type MergedTheme<TBase extends object, TExtension extends object> = DeepMerge<TBase, TExtension> & object;
 //#endregion
 //#region src/style/theme.d.ts
@@ -524,6 +598,12 @@ declare const Theme: {
 //#endregion
 //#region src/composition/types.d.ts
 declare const COMPOSITION_SOURCE: unique symbol;
+/**
+ * Deck-generated composition values passed to every slide factory.
+ *
+ * `slideIndex` and `totalSlides` are source-local. `deckSlideIndex` and `deckTotalSlides` refer to
+ * the fully composed root deck after mounted sources are expanded.
+ */
 type CompositionContext = {
   readonly sourceKey?: string;
   readonly slideIndex: number;
@@ -531,63 +611,119 @@ type CompositionContext = {
   readonly deckSlideIndex: number;
   readonly deckTotalSlides: number;
 };
+/**
+ * The input shape for a slide factory.
+ *
+ * Root Decks receive only `composition`; Decks with Source Context also receive `context`.
+ *
+ * @typeParam TSourceContext - Source Context type required by the declaring Deck.
+ */
 type SlideFactoryInput<TSourceContext = void> = [TSourceContext] extends [void] ? {
   readonly composition: CompositionContext;
 } : {
   readonly context: TSourceContext;
   readonly composition: CompositionContext;
 };
-type SlideFactory<TSourceContext = void> = (input: SlideFactoryInput<TSourceContext>) => JsxNode;
+/**
+ * Slide factory input when a slide selects a Deck Template.
+ *
+ * The `template` handle exposes typed Template Area References for the selected template.
+ *
+ * @typeParam TSourceContext - Source Context type required by the declaring Deck.
+ * @typeParam TTemplates - Deck-local Slide Template set.
+ * @typeParam TTemplateName - Selected Slide Template name.
+ */
+type SlideFactoryInputWithTemplate<TSourceContext = void, TTemplates extends SlideTemplateSet = EmptySlideTemplateSet, TTemplateName extends TemplateName<TTemplates> = TemplateName<TTemplates>> = SlideFactoryInput<TSourceContext> & {
+  readonly template: TemplateHandle<TTemplates, TTemplateName>;
+};
+/**
+ * A callback that returns the authored JSX content for one slide.
+ *
+ * The returned JSX is slide content, not a public `<Slide>` wrapper.
+ *
+ * @typeParam TSourceContext - Source Context type required by the declaring Deck.
+ * @typeParam TInput - Factory input shape, including template handle when applicable.
+ */
+type SlideFactory<TSourceContext = void, TInput extends SlideFactoryInput<TSourceContext> = SlideFactoryInput<TSourceContext>> = (input: TInput) => JsxNode;
+/**
+ * Slide-level options for `deck.slide(...)`.
+ *
+ * `template` is available only when the Deck has a typed template set. `name`, `className`, and
+ * `style` apply to the slide declaration itself.
+ *
+ * @typeParam TTemplates - Deck-local Slide Template set.
+ * @typeParam TTemplateName - Selected Slide Template name.
+ */
+type SlideOptions<TTemplates extends SlideTemplateSet = EmptySlideTemplateSet, TTemplateName extends TemplateName<TTemplates> = TemplateName<TTemplates>> = {
+  readonly name?: string;
+  readonly className?: ClassNameValue;
+  readonly style?: SlideStyle;
+} & ([TemplateName<TTemplates>] extends [never] ? {
+  readonly template?: never;
+} : {
+  readonly template?: TTemplateName;
+});
+/**
+ * Maps parent Source Context into a mounted child Deck's Source Context.
+ *
+ * Source Context mappers are synchronous and do not receive Composition Context.
+ *
+ * @typeParam TParentContext - Source Context type of the parent Deck.
+ * @typeParam TChildContext - Source Context type required by the child Deck.
+ */
 type SourceContextMapper<TParentContext, TChildContext> = [TParentContext] extends [void] ? () => TChildContext : (context: TParentContext) => TChildContext;
 type SourceContextInput<TParentContext, TChildContext> = TChildContext | SourceContextMapper<TParentContext, TChildContext>;
-type SourceContextBinding<TSourceContext = unknown> = {
+type SourceContextValue = JsxNode | {
+  readonly [key: string]: SourceContextValue;
+};
+type SourceContextBinding<TSourceContext = void> = {
   readonly present: false;
 } | {
   readonly present: true;
   readonly value: TSourceContext;
 };
-type CompositionEntry<TSourceContext = unknown> = {
+type CompositionEntry<TSourceContext extends SourceContextValue | void = void, TTemplates extends SlideTemplateSet = SlideTemplateSet> = {
   readonly kind: "slide";
-  readonly factory: SlideFactory<TSourceContext>;
+  readonly options?: SlideOptions<TTemplates>;
+  readonly factory: SlideFactory<TSourceContext, SlideFactoryInput<TSourceContext> & object> | SlideFactory<TSourceContext, SlideFactoryInputWithTemplate<TSourceContext, TTemplates, TemplateName<TTemplates>>>;
 } | {
   readonly kind: "mount";
   readonly sourceKey: string;
-  readonly source: CompositionSource<unknown>;
-  readonly contextProvider?: SourceContextInput<TSourceContext, unknown>;
+  readonly source: CompositionSource<SourceContextValue, SlideTemplateSet>;
+  readonly contextProvider?: SourceContextInput<TSourceContext, SourceContextValue>;
   readonly invalidExtraContext?: boolean;
 };
-type CompositionSourceInternals<TSourceContext = unknown> = {
-  readonly entries: readonly CompositionEntry<TSourceContext>[];
+type CompositionSourceInternals<TSourceContext extends SourceContextValue | void = void, TTemplates extends SlideTemplateSet = SlideTemplateSet> = {
+  readonly entries: readonly CompositionEntry<TSourceContext, TTemplates>[];
   readonly stylesheets: readonly StyleSheet[];
   readonly theme?: Theme;
+  readonly templates?: SlideTemplateSet;
   readonly cycleId: object;
   readonly boundContext: SourceContextBinding<TSourceContext>;
 };
-type CompositionSource<TSourceContext = unknown> = {
-  readonly [COMPOSITION_SOURCE]: () => CompositionSourceInternals<TSourceContext>;
+type CompositionSource<TSourceContext extends SourceContextValue | void = void, TTemplates extends SlideTemplateSet = SlideTemplateSet> = {
+  readonly [COMPOSITION_SOURCE]: () => CompositionSourceInternals<TSourceContext, TTemplates>;
 };
 //#endregion
 //#region src/authoring/index.d.ts
+type DeckJsxElement = {
+  readonly $$typeof: "deckjsx.author-tree" | "deckjsx.author-node";
+};
 interface TextJsxChildArray extends ReadonlyArray<TextJsxChild> {}
-type TextJsxChild = AuthorTreeNode | string | number | boolean | null | undefined | TextJsxChildArray;
+type TextJsxChild = DeckJsxElement | string | number | boolean | null | undefined | TextJsxChildArray;
 interface ContentJsxChildArray extends ReadonlyArray<ContentJsxChild> {}
-type ContentJsxChild = AuthorNode | AuthorTreeNode | boolean | null | undefined | ContentJsxChildArray;
+type ContentJsxChild = DeckJsxElement | boolean | null | undefined | ContentJsxChildArray;
 interface ViewIntrinsicJsxChildArray extends ReadonlyArray<ViewIntrinsicJsxChild> {}
 type ViewIntrinsicJsxChild = ContentJsxChild | string | number | ViewIntrinsicJsxChildArray;
 interface JsxNodeArray extends ReadonlyArray<JsxNode> {}
-type JsxNode = AuthorNode | AuthorTreeNode | string | number | boolean | null | undefined | JsxNodeArray;
-interface ClassNameValueArray extends ReadonlyArray<ClassNameValue> {}
-type ClassNameObject = Readonly<Record<string, boolean | null | undefined>>;
-type ClassNameValue = string | false | null | undefined | ClassNameValueArray | ClassNameObject;
-type ClassNameAuthorProps = {
-  className?: ClassNameValue;
-};
-type DeckOptions = {
+type JsxNode = DeckJsxElement | string | number | boolean | null | undefined | JsxNodeArray;
+type DeckOptions<TTemplates extends SlideTemplateSet = EmptySlideTemplateSet> = {
   layout: {
     width: number;
     height: number;
     unit: "in" | "pt";
   };
+  templates?: TTemplates;
   meta?: {
     title?: string;
     author?: string;
@@ -598,102 +734,32 @@ type DeckOptions = {
     format?: "pptx";
   };
 };
-type SlideContext = {
-  composition: CompositionContext;
-};
-type SlideNodeProps = {
-  name?: string;
-  className?: ClassNameValue;
-  style?: SlideStyle;
-  background?: string;
-  backgroundImage?: string;
-  backgroundColor?: string;
-  backgroundTransparency?: number;
-  backgroundPosition?: string;
-  backgroundSize?: string;
-  backgroundRepeat?: string;
-  backgroundClip?: string;
-  backgroundOrigin?: string;
-};
-type SlideProps = SlideNodeProps & {
-  children?: ContentJsxChild;
-};
-type ViewNodeProps = {
-  style?: ViewStyle;
-} & ClassNameAuthorProps & ViewStyle;
-type ViewProps = ViewNodeProps & {
-  children?: ContentJsxChild;
-};
-type TextNodeProps = {
-  style?: TextStyle;
-} & ClassNameAuthorProps & TextStyle;
-type TextProps = TextNodeProps & {
-  children?: TextJsxChild;
-};
-type TextRunNodeProps = {
-  style?: TextRunStyle;
-} & ClassNameAuthorProps & TextRunStyle;
-type ImageNodeProps = {
-  style?: ImageStyle;
-} & ClassNameAuthorProps & ImageStyle & ({
-  src: string;
-  data?: string;
-} | {
-  src?: string;
-  data: string;
-});
 type ImageProps = ImageNodeProps & {
   children?: never;
 };
-type ShapeNodeProps = {
-  style?: ShapeStyle;
-  shape: "rect" | "ellipse" | "line";
-} & ClassNameAuthorProps & ShapeStyle;
 type ShapeProps = ShapeNodeProps & {
   children?: never;
 };
-type AuthorNodeMap = {
-  slide: SlideProps;
-  view: ViewProps;
-  text: TextProps;
-  image: ImageProps;
-  shape: ShapeProps;
-};
-type AuthorNodeKind = keyof AuthorNodeMap;
-type BaseAuthorNode<K extends AuthorNodeKind, P, C> = {
-  readonly $$typeof: "deckjsx.author-node";
-  readonly kind: K;
-  readonly props: P;
-  readonly children: ReadonlyArray<C>;
-};
-interface SlideAuthorNode extends BaseAuthorNode<"slide", SlideNodeProps, ContentJsxChild> {}
-interface ViewAuthorNode extends BaseAuthorNode<"view", ViewNodeProps, ContentJsxChild> {}
-interface TextAuthorNode extends BaseAuthorNode<"text", TextNodeProps, TextJsxChild> {}
-interface ImageAuthorNode extends BaseAuthorNode<"image", ImageNodeProps, never> {}
-interface ShapeAuthorNode extends BaseAuthorNode<"shape", ShapeNodeProps, never> {}
-type AuthorNodeByKind = {
-  slide: SlideAuthorNode;
-  view: ViewAuthorNode;
-  text: TextAuthorNode;
-  image: ImageAuthorNode;
-  shape: ShapeAuthorNode;
-};
-type AuthorNode<K extends AuthorNodeKind = AuthorNodeKind> = AuthorNodeByKind[K];
-type IntrinsicDivProps = ViewNodeProps & {
+type IntrinsicKeyProps = {
+  key?: JsxKey;
+};
+type IntrinsicDivProps = ViewNodeProps & IntrinsicKeyProps & {
   children?: ViewIntrinsicJsxChild;
 };
-type IntrinsicPProps = TextNodeProps & {
+type IntrinsicPProps = TextNodeProps & IntrinsicKeyProps & {
   children?: TextJsxChild;
 };
-type IntrinsicSpanProps = TextRunNodeProps & {
+type IntrinsicSpanProps = TextRunNodeProps & IntrinsicKeyProps & {
   children?: TextJsxChild;
 };
-type IntrinsicImgProps = ImageProps;
+type IntrinsicImgProps = ImageProps & IntrinsicKeyProps;
+type IntrinsicShapeProps = ShapeProps & IntrinsicKeyProps;
 type IntrinsicViewTag = "article" | "aside" | "div" | "figure" | "footer" | "header" | "main" | "nav" | "section";
 type IntrinsicTextTag = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p";
 type DeckJsxIntrinsicElements = {
   img: IntrinsicImgProps;
+  shape: IntrinsicShapeProps;
   span: IntrinsicSpanProps;
 } & { [Tag in IntrinsicViewTag]: IntrinsicDivProps } & { [Tag in IntrinsicTextTag]: IntrinsicPProps };
 //#endregion
-export { CssOverflow as $, DeckDiagnosticError as $t, ThemeDefaults as A, SemanticContainerNode as At, CssFlexDirection as B, SemanticTextRunNode as Bt, CompositionSourceInternals as C, ViewStyle as Ct, SourceContextMapper as D, Brand as Dt, SourceContextInput as E, BaseSemanticNode as Et, CssAlignSelf as F, SemanticOrigin as Ft, CssGridShorthand as G, StyleEntityId as Gt, CssGridAutoFlow as H, SourceOrigin as Ht, CssAspectRatio as I, SemanticRole as It, CssGridTemplateShorthand as J, DiagnosticSeverity as Jt, CssGridTemplate as K, Diagnostic as Kt, CssBoxSizing as L, SemanticShapeNode as Lt, BorderStyle as M, SemanticImageNode as Mt, CssAlignContent as N, SemanticNode as Nt, Theme as O, GraphNodeId as Ot, CssAlignItems as P, SemanticNodeKind as Pt, CssObjectPosition as Q, CompositionDiagnosticError as Qt, CssDisplay as R, SemanticSlideNode as Rt, CompositionSource as S, VerticalAlign as St, SlideFactoryInput as T, AssetEntityId as Tt, CssGridLine as U, StyleClassRef as Ut, CssFlexWrap as V, SourceIdentity as Vt, CssGridPlacement as W, StyleEntity as Wt, CssJustifyContent as X, formatDiagnostic as Xt, CssGridTrack as Y, Diagnostics as Yt, CssJustifySelf as Z, formatDiagnostics as Zt, TextProps as _, TextRunStyle as _t, DeckJsxIntrinsicElements as a, JsxKey as an, ImageCropValue as at, COMPOSITION_SOURCE as b, TextTabStopAuthoring as bt, IntrinsicDivProps as c, IntrinsicViewTag$1 as cn, ShapeStyle as ct, IntrinsicTextTag as d, StackAlignment as dt, SemanticGraphDiagnosticError as en, CssPosition as et, IntrinsicViewTag as f, StackAxis as ft, TextJsxChild as g, TextFit as gt, SlideProps as h, StrokeLineJoin as ht, ContentJsxChild as i, AuthorTreeNode as in, ImageCropAuthoring as it, StyleSheet as j, SemanticDocumentNode as jt, ThemeInput as k, SemanticAuthorGraph as kt, IntrinsicImgProps as l, SlideStyle as lt, SlideContext as m, StrokeLineCap as mt, ClassNameValue as n, AuthorElementNode as nn, DeckLength as nt, DeckOptions as o, SourceSpan as on, ImageStyle as ot, ShapeProps as p, StrokeDashType as pt, CssGridTemplateAreas as q, DiagnosticLabel as qt, ClassNameValueArray as r, AuthorTreeChild as rn, DeckPointLength as rt, ImageProps as s, IntrinsicTextTag$1 as sn, LayoutMode as st, ClassNameObject as t, StyleDiagnosticError as tn, CssVisibility as tt, IntrinsicPProps as u, Spacing as ut, TextRunNodeProps as v, TextStyle as vt, SlideFactory as w, AssetEntity as wt, CompositionContext as x, TextTabStopLength as xt, ViewProps as y, TextTabStopAlignment as yt, CssFlexBasis as z, SemanticTextNode as zt };
+export { Diagnostics as $, StackAlignment as $t, BaseSemanticNode as A, CssGridAutoFlow as At, SemanticRole as B, CssObjectPosition as Bt, SourceContextValue as C, CssAlignSelf as Ct, StyleSheet as D, CssFlexBasis as Dt, ThemeDefaults as E, CssDisplay as Et, SemanticDocumentNode as F, CssGridTemplateAreas as Ft, SourceIdentity as G, DeckPointLength as Gt, SemanticSlideNode as H, CssPosition as Ht, SemanticImageNode as I, CssGridTemplateShorthand as It, StyleEntity as J, ImageStyle as Jt, SourceOrigin as K, ImageCropAuthoring as Kt, SemanticNode as L, CssGridTrack as Lt, GraphNodeId as M, CssGridPlacement as Mt, SemanticAuthorGraph as N, CssGridShorthand as Nt, AssetEntity as O, CssFlexDirection as Ot, SemanticContainerNode as P, CssGridTemplate as Pt, DiagnosticSeverity as Q, Spacing as Qt, SemanticNodeKind as R, CssJustifyContent as Rt, SourceContextMapper as S, CssAlignItems as St, ThemeInput as T, CssBoxSizing as Tt, SemanticTextNode as U, CssVisibility as Ut, SemanticShapeNode as V, CssOverflow as Vt, SemanticTextRunNode as W, DeckLength as Wt, Diagnostic as X, ShapeStyle as Xt, StyleEntityId as Y, LayoutMode as Yt, DiagnosticLabel as Z, SlideStyle as Zt, SlideFactory as _, TemplateFrame as _t, IntrinsicDivProps as a, StyleDeclarationValue as an, StyleDiagnosticError as at, SlideOptions as b, BorderStyle as bt, IntrinsicShapeProps as c, TextStyle as cn, ClassNameObject as ct, JsxNode as d, TextTabStopLength as dn, EmptySlideTemplateSet as dt, StackAxis as en, formatDiagnostic as et, TextJsxChild as f, VerticalAlign as fn, SlideTemplate as ft, CompositionSourceInternals as g, TemplateAreaRef as gt, CompositionSource as h, TemplateAreaKind as ht, DeckOptions as i, StyleDeclaration as in, SemanticGraphDiagnosticError as it, Brand as j, CssGridLine as jt, AssetEntityId as k, CssFlexWrap as kt, IntrinsicTextTag as l, TextTabStopAlignment as ln, ClassNameValue as lt, CompositionContext as m, TemplateArea as mt, DeckJsxElement as n, StrokeLineCap as nn, CompositionDiagnosticError as nt, IntrinsicImgProps as o, TextFit as on, JsxKey as ot, COMPOSITION_SOURCE as p, ViewStyle as pn, SlideTemplateSet as pt, StyleClassRef as q, ImageCropValue as qt, DeckJsxIntrinsicElements as r, StrokeLineJoin as rn, DeckDiagnosticError as rt, IntrinsicPProps as s, TextRunStyle as sn, SourceSpan as st, ContentJsxChild as t, StrokeDashType as tn, formatDiagnostics as tt, IntrinsicViewTag as u, TextTabStopAuthoring as un, ClassNameValueArray as ut, SlideFactoryInput as v, TemplateHandle as vt, Theme as w, CssAspectRatio as wt, SourceContextInput as x, CssAlignContent as xt, SlideFactoryInputWithTemplate as y, TemplateName as yt, SemanticOrigin as z, CssJustifySelf as zt };