@openpresentation/opf 0.11.0 → 0.11.1

package/dist/{chunk-RS5GZ5RW.js → chunk-SDETQV7Y.js}

@@ -6,6 +6,12 @@ var specFileEntries = [
     "kind": "spec",
     "mediaType": "text/markdown"
   },
+  {
+    "path": "catalogs/audiences/academic.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/academic.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/audiences/all-hands.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/audiences/all-hands.json",
@@ -24,6 +30,12 @@ var specFileEntries = [
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/audiences/customer.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/customer.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/audiences/customers.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/audiences/customers.json",
@@ -36,18 +48,42 @@ var specFileEntries = [
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/audiences/executive.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/executive.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/audiences/executives.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/audiences/executives.json",
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/audiences/general-public.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/general-public.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/audiences/index.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/audiences/index.json",
     "kind": "catalogIndex",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/audiences/internal-team.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/internal-team.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "catalogs/audiences/investor.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/investor.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/audiences/investors.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/audiences/investors.json",
@@ -60,18 +96,54 @@ var specFileEntries = [
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/audiences/marketing.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/marketing.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "catalogs/audiences/media.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/media.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "catalogs/audiences/partner.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/partner.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/audiences/regulators.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/audiences/regulators.json",
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/audiences/regulatory.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/regulatory.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/audiences/sales-team.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/audiences/sales-team.json",
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/audiences/sales.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/sales.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "catalogs/audiences/technical.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/audiences/technical.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/chart-types/100pct-bullet-bar-2x.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/chart-types/100pct-bullet-bar-2x.json",
@@ -1950,6 +2022,12 @@ var specFileEntries = [
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/narratives/change-story.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/narratives/change-story.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/narratives/classic-story.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/narratives/classic-story.json",
@@ -1968,6 +2046,12 @@ var specFileEntries = [
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/narratives/data-story.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/narratives/data-story.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/narratives/early-startup-pitch.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/narratives/early-startup-pitch.json",
@@ -2004,6 +2088,12 @@ var specFileEntries = [
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/narratives/heros-journey.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/narratives/heros-journey.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/narratives/index.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/narratives/index.json",
@@ -2076,6 +2166,12 @@ var specFileEntries = [
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/narratives/pyramid-principle.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/narratives/pyramid-principle.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/narratives/qbr.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/narratives/qbr.json",
@@ -2100,6 +2196,24 @@ var specFileEntries = [
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/narratives/situation-complication-resolution.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/narratives/situation-complication-resolution.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "catalogs/narratives/sparkline.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/narratives/sparkline.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "catalogs/narratives/star-method.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/narratives/star-method.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/narratives/status-update.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/narratives/status-update.json",
@@ -2154,12 +2268,24 @@ var specFileEntries = [
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/narratives/vision-roadmap.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/narratives/vision-roadmap.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/narratives/weekly-progress.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/narratives/weekly-progress.json",
     "kind": "catalogRecord",
     "mediaType": "application/json"
   },
+  {
+    "path": "catalogs/narratives/what-so-what-now-what.json",
+    "packagePath": "@openpresentation/opf/spec/catalogs/narratives/what-so-what-now-what.json",
+    "kind": "catalogRecord",
+    "mediaType": "application/json"
+  },
   {
     "path": "catalogs/purposes/align.json",
     "packagePath": "@openpresentation/opf/spec/catalogs/purposes/align.json",
@@ -2802,6 +2928,18 @@ var specFileEntries = [
     "kind": "reference",
     "mediaType": "application/json"
   },
+  {
+    "path": "reference/font-policy.json",
+    "packagePath": "@openpresentation/opf/spec/reference/font-policy.json",
+    "kind": "reference",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "reference/font-policy.schema.json",
+    "packagePath": "@openpresentation/opf/spec/reference/font-policy.schema.json",
+    "kind": "reference",
+    "mediaType": "application/json"
+  },
   {
     "path": "schemas/audience.schema.json",
     "packagePath": "@openpresentation/opf/spec/schemas/audience.schema.json",
@@ -2889,17 +3027,29 @@ var specFileEntries = [
 ];
 var specFilePaths = [
   "README.md",
+  "catalogs/audiences/academic.json",
   "catalogs/audiences/all-hands.json",
   "catalogs/audiences/board.json",
   "catalogs/audiences/candidates.json",
+  "catalogs/audiences/customer.json",
   "catalogs/audiences/customers.json",
   "catalogs/audiences/engineering-team.json",
+  "catalogs/audiences/executive.json",
   "catalogs/audiences/executives.json",
+  "catalogs/audiences/general-public.json",
   "catalogs/audiences/index.json",
+  "catalogs/audiences/internal-team.json",
+  "catalogs/audiences/investor.json",
   "catalogs/audiences/investors.json",
   "catalogs/audiences/marketing-team.json",
+  "catalogs/audiences/marketing.json",
+  "catalogs/audiences/media.json",
+  "catalogs/audiences/partner.json",
   "catalogs/audiences/regulators.json",
+  "catalogs/audiences/regulatory.json",
   "catalogs/audiences/sales-team.json",
+  "catalogs/audiences/sales.json",
+  "catalogs/audiences/technical.json",
   "catalogs/chart-types/100pct-bullet-bar-2x.json",
   "catalogs/chart-types/100pct-bullet-bar-3x.json",
   "catalogs/chart-types/100pct-bullet-bar.json",
@@ -3213,15 +3363,18 @@ var specFilePaths = [
   "catalogs/narratives/business-review.json",
   "catalogs/narratives/capacity-planning.json",
   "catalogs/narratives/challenge-resolution.json",
+  "catalogs/narratives/change-story.json",
   "catalogs/narratives/classic-story.json",
   "catalogs/narratives/company-intro.json",
   "catalogs/narratives/conference-talk.json",
+  "catalogs/narratives/data-story.json",
   "catalogs/narratives/early-startup-pitch.json",
   "catalogs/narratives/educate.json",
   "catalogs/narratives/employee-review.json",
   "catalogs/narratives/failure-analysis.json",
   "catalogs/narratives/focus.json",
   "catalogs/narratives/golden-circle.json",
+  "catalogs/narratives/heros-journey.json",
   "catalogs/narratives/index.json",
   "catalogs/narratives/innovation.json",
   "catalogs/narratives/justice.json",
@@ -3234,10 +3387,14 @@ var specFilePaths = [
   "catalogs/narratives/problem-solution.json",
   "catalogs/narratives/product-launch.json",
   "catalogs/narratives/project-proposal.json",
+  "catalogs/narratives/pyramid-principle.json",
   "catalogs/narratives/qbr.json",
   "catalogs/narratives/rags-to-riches.json",
   "catalogs/narratives/reveal.json",
   "catalogs/narratives/scqa.json",
+  "catalogs/narratives/situation-complication-resolution.json",
+  "catalogs/narratives/sparkline.json",
+  "catalogs/narratives/star-method.json",
   "catalogs/narratives/status-update.json",
   "catalogs/narratives/strategic-advisory.json",
   "catalogs/narratives/strategic-narrative.json",
@@ -3247,7 +3404,9 @@ var specFilePaths = [
   "catalogs/narratives/trend-analysis.json",
   "catalogs/narratives/underdog-victory.json",
   "catalogs/narratives/venture-pitch.json",
+  "catalogs/narratives/vision-roadmap.json",
   "catalogs/narratives/weekly-progress.json",
+  "catalogs/narratives/what-so-what-now-what.json",
   "catalogs/purposes/align.json",
   "catalogs/purposes/decide.json",
   "catalogs/purposes/educate.json",
@@ -3355,6 +3514,8 @@ var specFilePaths = [
   "previews/layouts/waterfall-bridge.html",
   "previews/layouts/wheel-radial.html",
   "reference/engine-defaults.json",
+  "reference/font-policy.json",
+  "reference/font-policy.schema.json",
   "schemas/audience.schema.json",
   "schemas/catalog-index.schema.json",
   "schemas/chart-type.schema.json",

package/dist/{composition-Tv9Wm3Oh.d.ts → composition-DzLwY-Mi.d.ts}

@@ -41,6 +41,36 @@ declare function tableGrid(value: unknown, path?: string): TableGrid;
 /** Row boundaries that preserve every vertical merge, used by pagination. */
 declare function tableRowBoundaries(value: unknown): number[];
 
+/**
+ * Deterministic header/footer field formatting. Nothing here consults a clock,
+ * the host locale or the host time zone: dates are calendar dates supplied by the
+ * document or the host, and month/weekday names are fixed English names.
+ */
+/** A live field inside displayed furniture text, as half-open UTF-16 offsets into the part's `text`. */
+interface FurnitureField {
+    type: 'slideNumber' | 'date';
+    start: number;
+    end: number;
+    /** Resolved date pattern for a current (`date: true`) date. */
+    format?: string;
+}
+/** PowerPoint's first Insert > Date and Time choice for en-US (`datetime1`). */
+declare const DEFAULT_FURNITURE_DATE_FORMAT = "M/d/yyyy";
+declare const DEFAULT_SLIDE_NUMBER_FORMAT = "{current}";
+/** Format an ISO calendar date with an LDML-style pattern. Returns an error message when either input is unsupported. */
+declare function formatFurnitureDate(iso: string, pattern: string): {
+    text: string;
+} | {
+    error: string;
+};
+/** Resolve a slide-number template. `{current}` becomes a live field; `{total}` is fixed text. */
+declare function formatSlideNumber(format: string, current: number, total: number | undefined): {
+    text: string;
+    fields: FurnitureField[];
+} | {
+    error: string;
+};
+
 /** Normalize a literal hex color to uppercase #RRGGBB. */
 declare function normalizeHexColor(value: unknown): string | undefined;
 type ResolveColorRefRoles = Partial<Record<'primary' | 'secondary' | 'accent' | 'background' | 'surface' | 'text' | 'textSecondary', string>>;
@@ -88,7 +118,7 @@ interface LayoutBox {
     height: number;
 }
 interface LayoutDiagnostic {
-    code: "text-overflow" | "small-cell" | "unresolved-content";
+    code: "text-overflow" | "small-cell" | "unresolved-content" | "unsupported-image-treatment";
     path: string;
     message: string;
 }
@@ -110,6 +140,36 @@ interface FontFamilies {
     body: string;
     code: string;
 }
+/** Shared last-resort font-scheme id when neither the slide, the deck nor the resolved theme names one.
+ * One default for every engine, so preview matches export (font-fidelity-everywhere owner decision). */
+declare const DEFAULT_FONT_SCHEME = "aptos";
+/** Reported when a font-scheme id matches no inline or bundled record. Every engine then uses the
+ * DEFAULT_FONT_SCHEME record as the base, with any sibling overrides on top. */
+interface FontSchemeDiagnostic {
+    code: "unresolved-font-scheme";
+    /** Where the unresolved id is written: `slides.N.design.fontScheme`, `design.fontScheme`, or the
+     * `design.theme` reference whose record names it. */
+    path: string;
+    message: string;
+    /** The unresolved font-scheme id. */
+    id: string;
+    /** The font scheme used instead (DEFAULT_FONT_SCHEME). */
+    fallback: string;
+}
+interface ResolvedFontScheme {
+    scheme: Record<string, unknown>;
+    diagnostic?: FontSchemeDiagnostic;
+}
+/** Resolve a font-scheme reference the same way in every engine. A string id, or the `id` of an object
+ * reference, resolves through `lookup` (inline records, then bundled or host catalogs). An unresolved id
+ * returns a diagnostic, and the DEFAULT_FONT_SCHEME record becomes the base, so preview and export use
+ * the same families. An object without `id` is an inline scheme on the same base. Sibling fields on an
+ * object reference override the base per key. */
+declare function resolveFontSchemeReference(reference: unknown, lookup: (id: string) => unknown, path?: string): ResolvedFontScheme;
+/** Resolve role families from an already-merged font scheme (catalog record plus design overrides).
+ * A scheme that names no heading or body family gets the DEFAULT_FONT_SCHEME families (Aptos Display, Aptos).
+ * `code` comes from the scheme's `code` role, which catalog records such as consolas and courier-new
+ * carry; otherwise it is Roboto Mono. Heading and body families are never reused for code. */
 declare function resolveFontFamilies(input: unknown): FontFamilies;
 interface TextMeasurement {
     measure: (text: string, fontSize: number, style: TextStyle) => number;
@@ -177,6 +237,69 @@ interface ComposedItem {
     timelineLayout?: TimelineLayout;
     /** Effective container settings, including inherited readability constraints. */
     composition: Composition;
+    /**
+     * Resolved horizontal text alignment for this item: titleAlignment for the
+     * title, contentAlignment for every other item (slide design, then host
+     * option, then left). Engines anchor native and preview text to this value.
+     */
+    alignment: 'left' | 'center' | 'right';
+}
+/**
+ * Slide-level image resolved from design.slideImage. It is active when the slide sets its own
+ * design.slideImage, or when the deck sets one and either the slide's layout record declares
+ * slideImage: true or the slide's root image is the same source.
+ * Content composes in the part of the slide the image does not occupy; 'background' leaves the whole slide.
+ */
+interface ComposedSlideImage {
+    /** The design value that configured the image: 'design.slideImage' or 'slides.N.design.slideImage'. */
+    path: string;
+    /** Path of the drawn asset value: the design value, or the slide's root image payload it replaced. */
+    sourcePath: string;
+    /** Asset value (string or Asset object) that engines resolve like any other image. */
+    value: unknown;
+    position: 'background' | 'top' | 'bottom' | 'left' | 'right';
+    /** crop covers the frame (centered); fit shows the whole image centered inside it. */
+    fill: 'crop' | 'fit';
+    /** Band allocated to the image. */
+    region: LayoutBox;
+    /** Image frame inside the region. */
+    box: LayoutBox;
+    /** True when the slide's root image payload became this slide image instead of a content item. */
+    replacesContent: boolean;
+    /** Treatment alt text; engines fall back to the asset's own alt text. */
+    alt?: string;
+    /** Mask on the frame: a DrawingML preset with its guide values, and the same outline as an SVG path. */
+    shape: SlideImageShape;
+    /** Line centered on the shape outline; width in reference pixels (already scaled to the canvas). */
+    border?: {
+        color: unknown;
+        width: number;
+    };
+    /** Image opacity below 1; the border and overlay are not affected. */
+    opacity?: number;
+    /** Luminance-based recolor (Rec. 601 weights on sRGB values). */
+    recolor?: {
+        type: 'grayscale';
+    } | {
+        type: 'duotone';
+        dark: unknown;
+        light: unknown;
+    };
+    /** Scrim over the frame (same shape) or over an edge band of a rectangle frame. */
+    overlay?: {
+        color: unknown;
+        opacity: number;
+        box: LayoutBox;
+        shape: SlideImageShape;
+    };
+}
+/** A frame mask. path follows the ECMA-376 preset formula for preset/adjust exactly, in reference pixels. */
+interface SlideImageShape {
+    kind: 'rectangle' | 'rounded' | 'circle' | 'hexagon';
+    preset: 'rect' | 'roundRect' | 'ellipse' | 'hexagon';
+    /** DrawingML avLst guide values (for example adj and vf), in 1/100000 units. */
+    adjust: Record<string, number>;
+    path: string;
 }
 interface ComposedGroup {
     path: string;
@@ -245,19 +368,39 @@ interface SlideComposition {
     composition: Composition;
     /** Repeated furniture is measured separately from body pagination leaves. */
     furniture?: FurnitureLayout;
+    /** Active slide-level image; absent when design.slideImage does not apply to this slide. */
+    slideImage?: ComposedSlideImage;
     explanation?: CompositionExplanation;
 }
 interface ComposeSlideOptions {
-    /** Context for inherited furniture and generated organization names. */
+    /** Context for inherited furniture, generated organization names and social profiles. */
     presentation?: {
         design?: {
             header?: unknown;
             footer?: unknown;
+            slideImage?: unknown;
+            imageFill?: unknown;
         };
         organization?: unknown;
+        slides?: unknown;
+        catalogs?: unknown;
     };
+    /**
+     * Host-resolved social-platform records for generated `socials` furniture.
+     * Inline `presentation.catalogs.socialPlatforms.records` take precedence. Hosts
+     * normally pass the bundled catalog; without a matching record a handle renders
+     * as its raw value, as the Socials contract specifies.
+     */
+    socialPlatforms?: readonly SocialPlatformRecord[];
     /** One-based displayed number; source paths still use slideIndex. */
     slideNumber?: number;
+    /** Displayed slide count for `{total}` in slideNumberFormat. Defaults to `presentation.slides.length`. */
+    slideCount?: number;
+    /**
+     * Host-supplied current calendar date (ISO YYYY-MM-DD) for `date: true` furniture. Core never
+     * consults a clock; without this option a current date is reported as unresolved content.
+     */
+    date?: string;
     fonts?: Partial<FontFamilies>;
     /** Host-resolved alignment for shared content; slide design can override it. */
     contentAlignment?: 'left' | 'center' | 'right';
@@ -280,10 +423,15 @@ declare class OPFCompositionError extends Error {
     readonly explanation?: CompositionExplanation;
     constructor(diagnostics: LayoutDiagnostic[], explanation?: CompositionExplanation);
 }
+/**
+ * Outline of a DrawingML preset in a box, following the ECMA-376 presetShapeDefinitions formulas:
+ * roundRect (adj; ss = min(w,h), radius = ss*adj/100000), ellipse, and hexagon (adj, vf).
+ */
+declare function slideImageShape(kind: SlideImageShape['kind'], box: LayoutBox, cornerRadius?: number): SlideImageShape;
 interface FurniturePartBase {
     kind: 'header' | 'footer';
     zone: 'left' | 'center' | 'right';
-    field: 'text' | 'image' | 'organization' | 'section' | 'slideNumber' | 'date';
+    field: 'text' | 'image' | 'organization' | 'socials' | 'section' | 'slideNumber' | 'date';
     /** Literal field or controlling flag, with the actual inherited/local path. */
     path: string;
     /** String/asset source, when different from a generated field's flag. */
@@ -299,7 +447,53 @@ interface FurnitureTextPart extends FurniturePartBase {
     requestedFontSize: number;
     minFontSize: number;
     fit: SourceTextFit;
+    /**
+     * Live values inside `text`: every `{current}` slide number, and a whole current
+     * (`date: true`) date. Hosts such as PPTX may emit them as native fields; all other
+     * text, including `{total}` and formatted fixed dates, is fixed.
+     */
+    fields?: FurnitureField[];
+    /**
+     * Generated `socials` only: one entry per explicit source line of `text`, in
+     * order. A part may carry both `fields` and `links`; hosts apply each link to
+     * its whole source line and each field range within it.
+     */
+    links?: FurnitureSocialLink[];
+}
+/** Optional generated metadata for one furniture text part (live fields and/or social links). */
+interface FurnitureTextExtras {
+    fields?: FurnitureField[];
+    links?: FurnitureSocialLink[];
+}
+/** Social-platform catalog fields used to format a profile. */
+interface SocialPlatformRecord {
+    id: string;
+    name?: string;
+    baseUrl?: string;
+    profileUrlPattern?: string;
+    companyUrlPattern?: string;
+    handlePrefix?: string;
+}
+interface SocialProfile {
+    /** Single-line display text: the profile URL without an `https://` scheme, or the raw value. */
+    text: string;
+    /** Full http(s) URL when the value is one or its platform record formats one. */
+    href?: string;
+    /** Whether a socialPlatforms record formatted a handle. */
+    resolved: boolean;
+}
+interface FurnitureSocialLink extends SocialProfile {
+    /** Socials key (platform id). */
+    platform: string;
+    /** Authored value path, such as `organization.socials.x`. */
+    sourcePath: string;
 }
+/**
+ * Format one Socials value through its platform record, deterministically and
+ * without network access. `owner` selects companyUrlPattern for organizations.
+ * URLs pass through; unknown platforms and unformattable values stay raw.
+ */
+declare function resolveSocialProfile(platform: string, value: string, records?: readonly SocialPlatformRecord[], owner?: 'organization' | 'speaker'): SocialProfile;
 interface FurnitureImagePart extends FurniturePartBase {
     type: 'image';
     image: unknown;
@@ -578,6 +772,8 @@ interface RichTextRun {
     subscript?: boolean;
 }
 interface RichTextFragment {
+    /** Tabs are source-preserving layout controls with a fixed advance, not glyph text. */
+    kind?: 'tab';
     text: string;
     runIndex: number;
     start: number;
@@ -688,4 +884,4 @@ declare function resolveCanvasDimensions(input: unknown): {
     height: number;
 };
 
-export { type TextFit as $, type ListValue as A, type MeasureTextWidth as B, type CodeContent as C, type MetricContent as D, type MetricLayout as E, type FontFamilies as F, type MetricLayoutDiagnostic as G, type MetricLayoutOptions as H, type MetricTextPart as I, type MetricTextSource as J, type QuoteLayout as K, type LayoutBox as L, MAX_COMPOSITION_DEPTH as M, type QuoteLayoutDiagnostic as N, OPFCompositionError as O, type QuoteLayoutOptions as P, type QuoteContent as Q, type QuoteTextPart as R, type QuoteTextSource as S, type ResolveColorRefOptions as T, type ResolveColorRefRoles as U, type RichTextFit as V, type RichTextFragment as W, type RichTextLine as X, type RichTextOptions as Y, type RichTextRun as Z, type SlideComposition as _, type CodeLayout as a, type TextLineInk as a0, type TextMeasurement as a1, type TextPlacement as a2, type TextPlacementLine as a3, type TextStyle as a4, type TimelineContent as a5, type TimelineEvent as a6, type TimelineLayout as a7, type TimelineLayoutDiagnostic as a8, type TimelineLayoutOptions as a9, type TableCellLayout as aA, type TableCellStyle as aB, type TableGrid as aC, type TableGridCell as aD, type TableGridIssue as aE, type TableLayout as aF, type TableLayoutOptions as aG, type TableRowLayout as aH, type TextLineSegment as aI, type TextLineSource as aJ, layoutTable as aK, tableGrid as aL, tableRowBoundaries as aM, type TimelineTextPart as aa, chartColorForFill as ab, colorContrast as ac, composeSlide as ad, fitList as ae, fitRichText as af, fitText as ag, layoutCode as ah, layoutFurniture as ai, layoutMetric as aj, layoutQuote as ak, layoutTimeline as al, measureText as am, measureTextOutline as an, normalizeHexColor as ao, placeTextLines as ap, resolveCanvasDimensions as aq, resolveColorRef as ar, resolveFontFamilies as as, resolveTextStyle as at, textColorForFill as au, textWidthMeasurer as av, wrapText as aw, type FontFaceSelection as ax, type SourceTextFit as ay, type TableBorder as az, type CodeLayoutDiagnostic as b, type CodeLayoutOptions as c, type CodeLineSegment as d, type CodeLineSource as e, type CodeTextFit as f, type CodeTextPart as g, type ComposeSlideOptions as h, type ComposedFlow as i, type ComposedGroup as j, type ComposedItem as k, type Composition as l, type CompositionCandidate as m, type CompositionDecision as n, type CompositionExplanation as o, type CompositionPenalties as p, type CompositionTrack as q, type FurnitureImagePart as r, type FurnitureLayout as s, type FurniturePart as t, type FurniturePartBase as u, type FurnitureTextPart as v, type LayoutDiagnostic as w, type ListEntryLayout as x, type ListFit as y, type ListText as z };
+export { type QuoteTextSource as $, type FurnitureSocialLink as A, type FurnitureTextExtras as B, type ComposeSlideOptions as C, DEFAULT_FONT_SCHEME as D, type FurnitureTextPart as E, type FontSchemeDiagnostic as F, type LayoutBox as G, type ListEntryLayout as H, type ListFit as I, type ListText as J, type ListValue as K, type LayoutDiagnostic as L, MAX_COMPOSITION_DEPTH as M, type MeasureTextWidth as N, type MetricContent as O, type MetricLayout as P, type MetricLayoutDiagnostic as Q, type MetricLayoutOptions as R, type MetricTextPart as S, type TextMeasurement as T, type MetricTextSource as U, OPFCompositionError as V, type QuoteContent as W, type QuoteLayout as X, type QuoteLayoutDiagnostic as Y, type QuoteLayoutOptions as Z, type QuoteTextPart as _, type CodeContent as a, slideImageShape as a$, type ResolveColorRefOptions as a0, type ResolveColorRefRoles as a1, type ResolvedFontScheme as a2, type RichTextFit as a3, type RichTextFragment as a4, type RichTextLine as a5, type RichTextOptions as a6, type RichTextRun as a7, type SlideComposition as a8, type SlideImageShape as a9, measureText as aA, measureTextOutline as aB, normalizeHexColor as aC, placeTextLines as aD, resolveCanvasDimensions as aE, resolveColorRef as aF, resolveFontFamilies as aG, resolveFontSchemeReference as aH, resolveSocialProfile as aI, resolveTextStyle as aJ, textColorForFill as aK, textWidthMeasurer as aL, wrapText as aM, type FontFaceSelection as aN, type SourceTextFit as aO, type TableBorder as aP, type TableCellLayout as aQ, type TableCellStyle as aR, type TableGrid as aS, type TableGridCell as aT, type TableGridIssue as aU, type TableLayout as aV, type TableLayoutOptions as aW, type TableRowLayout as aX, type TextLineSegment as aY, type TextLineSource as aZ, layoutTable as a_, type SocialPlatformRecord as aa, type SocialProfile as ab, type TextFit as ac, type TextLineInk as ad, type TextPlacement as ae, type TextPlacementLine as af, type TextStyle as ag, type TimelineContent as ah, type TimelineEvent as ai, type TimelineLayout as aj, type TimelineLayoutDiagnostic as ak, type TimelineLayoutOptions as al, type TimelineTextPart as am, chartColorForFill as an, colorContrast as ao, composeSlide as ap, fitList as aq, fitRichText as ar, fitText as as, formatFurnitureDate as at, formatSlideNumber as au, layoutCode as av, layoutFurniture as aw, layoutMetric as ax, layoutQuote as ay, layoutTimeline as az, type CodeLayout as b, tableGrid as b0, tableRowBoundaries as b1, type CodeLayoutDiagnostic as c, type CodeLayoutOptions as d, type CodeLineSegment as e, type CodeLineSource as f, type CodeTextFit as g, type CodeTextPart as h, type ComposedFlow as i, type ComposedGroup as j, type ComposedItem as k, type ComposedSlideImage as l, type Composition as m, type CompositionCandidate as n, type CompositionDecision as o, type CompositionExplanation as p, type CompositionPenalties as q, type CompositionTrack as r, DEFAULT_FURNITURE_DATE_FORMAT as s, DEFAULT_SLIDE_NUMBER_FORMAT as t, type FontFamilies as u, type FurnitureField as v, type FurnitureImagePart as w, type FurnitureLayout as x, type FurniturePart as y, type FurniturePartBase as z };

package/dist/composition.d.ts

@@ -1 +1 @@
-export { C as CodeContent, a as CodeLayout, b as CodeLayoutDiagnostic, c as CodeLayoutOptions, d as CodeLineSegment, e as CodeLineSource, f as CodeTextFit, g as CodeTextPart, h as ComposeSlideOptions, i as ComposedFlow, j as ComposedGroup, k as ComposedItem, l as Composition, m as CompositionCandidate, n as CompositionDecision, o as CompositionExplanation, p as CompositionPenalties, q as CompositionTrack, ax as FontFaceSelection, F as FontFamilies, r as FurnitureImagePart, s as FurnitureLayout, t as FurniturePart, u as FurniturePartBase, v as FurnitureTextPart, L as LayoutBox, w as LayoutDiagnostic, x as ListEntryLayout, y as ListFit, z as ListText, A as ListValue, M as MAX_COMPOSITION_DEPTH, B as MeasureTextWidth, D as MetricContent, E as MetricLayout, G as MetricLayoutDiagnostic, H as MetricLayoutOptions, I as MetricTextPart, J as MetricTextSource, O as OPFCompositionError, Q as QuoteContent, K as QuoteLayout, N as QuoteLayoutDiagnostic, P as QuoteLayoutOptions, R as QuoteTextPart, S as QuoteTextSource, V as RichTextFit, W as RichTextFragment, X as RichTextLine, Y as RichTextOptions, Z as RichTextRun, _ as SlideComposition, ay as SourceTextFit, az as TableBorder, aA as TableCellLayout, aB as TableCellStyle, aC as TableGrid, aD as TableGridCell, aE as TableGridIssue, aF as TableLayout, aG as TableLayoutOptions, aH as TableRowLayout, $ as TextFit, a0 as TextLineInk, aI as TextLineSegment, aJ as TextLineSource, a1 as TextMeasurement, a2 as TextPlacement, a3 as TextPlacementLine, a4 as TextStyle, a5 as TimelineContent, a6 as TimelineEvent, a7 as TimelineLayout, a8 as TimelineLayoutDiagnostic, a9 as TimelineLayoutOptions, aa as TimelineTextPart, ab as chartColorForFill, ac as colorContrast, ad as composeSlide, ae as fitList, af as fitRichText, ag as fitText, ah as layoutCode, ai as layoutFurniture, aj as layoutMetric, ak as layoutQuote, aK as layoutTable, al as layoutTimeline, am as measureText, an as measureTextOutline, ap as placeTextLines, aq as resolveCanvasDimensions, as as resolveFontFamilies, at as resolveTextStyle, aL as tableGrid, aM as tableRowBoundaries, au as textColorForFill, av as textWidthMeasurer, aw as wrapText } from './composition-Tv9Wm3Oh.js';
+export { a as CodeContent, b as CodeLayout, c as CodeLayoutDiagnostic, d as CodeLayoutOptions, e as CodeLineSegment, f as CodeLineSource, g as CodeTextFit, h as CodeTextPart, C as ComposeSlideOptions, i as ComposedFlow, j as ComposedGroup, k as ComposedItem, l as ComposedSlideImage, m as Composition, n as CompositionCandidate, o as CompositionDecision, p as CompositionExplanation, q as CompositionPenalties, r as CompositionTrack, D as DEFAULT_FONT_SCHEME, s as DEFAULT_FURNITURE_DATE_FORMAT, t as DEFAULT_SLIDE_NUMBER_FORMAT, aN as FontFaceSelection, u as FontFamilies, F as FontSchemeDiagnostic, v as FurnitureField, w as FurnitureImagePart, x as FurnitureLayout, y as FurniturePart, z as FurniturePartBase, A as FurnitureSocialLink, B as FurnitureTextExtras, E as FurnitureTextPart, G as LayoutBox, L as LayoutDiagnostic, H as ListEntryLayout, I as ListFit, J as ListText, K as ListValue, M as MAX_COMPOSITION_DEPTH, N as MeasureTextWidth, O as MetricContent, P as MetricLayout, Q as MetricLayoutDiagnostic, R as MetricLayoutOptions, S as MetricTextPart, U as MetricTextSource, V as OPFCompositionError, W as QuoteContent, X as QuoteLayout, Y as QuoteLayoutDiagnostic, Z as QuoteLayoutOptions, _ as QuoteTextPart, $ as QuoteTextSource, a2 as ResolvedFontScheme, a3 as RichTextFit, a4 as RichTextFragment, a5 as RichTextLine, a6 as RichTextOptions, a7 as RichTextRun, a8 as SlideComposition, a9 as SlideImageShape, aa as SocialPlatformRecord, ab as SocialProfile, aO as SourceTextFit, aP as TableBorder, aQ as TableCellLayout, aR as TableCellStyle, aS as TableGrid, aT as TableGridCell, aU as TableGridIssue, aV as TableLayout, aW as TableLayoutOptions, aX as TableRowLayout, ac as TextFit, ad as TextLineInk, aY as TextLineSegment, aZ as TextLineSource, T as TextMeasurement, ae as TextPlacement, af as TextPlacementLine, ag as TextStyle, ah as TimelineContent, ai as TimelineEvent, aj as TimelineLayout, ak as TimelineLayoutDiagnostic, al as TimelineLayoutOptions, am as TimelineTextPart, an as chartColorForFill, ao as colorContrast, ap as composeSlide, aq as fitList, ar as fitRichText, as as fitText, at as formatFurnitureDate, au as formatSlideNumber, av as layoutCode, aw as layoutFurniture, ax as layoutMetric, ay as layoutQuote, a_ as layoutTable, az as layoutTimeline, aA as measureText, aB as measureTextOutline, aD as placeTextLines, aE as resolveCanvasDimensions, aG as resolveFontFamilies, aH as resolveFontSchemeReference, aI as resolveSocialProfile, aJ as resolveTextStyle, a$ as slideImageShape, b0 as tableGrid, b1 as tableRowBoundaries, aK as textColorForFill, aL as textWidthMeasurer, aM as wrapText } from './composition-DzLwY-Mi.js';

package/dist/composition.js

@@ -1 +1 @@
-export { MAX_COMPOSITION_DEPTH, OPFCompositionError, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutFurniture, layoutMetric, layoutQuote, layoutTable, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText } from './chunk-FTWNWFIV.js';
+export { DEFAULT_FONT_SCHEME, DEFAULT_FURNITURE_DATE_FORMAT, DEFAULT_SLIDE_NUMBER_FORMAT, MAX_COMPOSITION_DEPTH, OPFCompositionError, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, formatFurnitureDate, formatSlideNumber, layoutCode, layoutFurniture, layoutMetric, layoutQuote, layoutTable, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveFontSchemeReference, resolveSocialProfile, resolveTextStyle, slideImageShape, tableGrid, tableRowBoundaries, textColorForFill, textWidthMeasurer, wrapText } from './chunk-6UPHKXI5.js';