@cueframe/kernel 0.2.51 → 0.2.53

package/dist/_members/composition/fonts/bundledFaces.d.ts

@@ -23,7 +23,9 @@ export interface BundledFontFace {
      */
     readonly weight: string;
     /** The `-<file>.woff2` suffix that carries it, i.e. `public/fonts/<slug>-<file>.woff2`. */
-    readonly file: "400" | "700";
+    readonly file: "400" | "700" | "400-italic";
+    /** Omitted for existing upright files; italic must name a real italic binary. */
+    readonly style?: "normal" | "italic";
 }
 /**
  * The weights a caption run is drawn at when the style names none.
@@ -56,8 +58,7 @@ export interface BundledFontFamilyFaces {
  * What bytes actually ship with the render bundle, per family.
  *
  * This is the single source for the two facts every font gate needs before it may claim a face is
- * reproducible: which weights a bundled or aliased family's file declares, and that no bundled or
- * aliased family ships an italic file at all. Both gates read this one table — render-entry's
+ * reproducible: which weights and styles each bundled or aliased family's files declare. Both gates read this one table — render-entry's
  * loader (`packages/execution/render-entry/src/fonts.ts`) derives its face table and its
  * `staticFile('fonts/<slug>-<file>.woff2')` URLs from it, and core's scene-shot sealing
  * (`sealSceneShotFonts`) admits a bundled face by it — so the host-side seal and the page-side
@@ -65,16 +66,11 @@ export interface BundledFontFamilyFaces {
  *
  * A declared weight range must not exceed what the file carries: outside it the browser
  * synthesises the face, which is a silent substitution, not a render. `fonts.test.ts` in
- * render-entry asserts every face here has bytes on disk and that no italic file exists, so these
+ * render-entry asserts every face here has bytes on disk and that its style matches the font metadata, so these
  * facts cannot drift away from the bytes.
  */
 export declare const BUNDLED_FONT_FACES: Readonly<Record<VendoredFontFamily | AliasedFontFamily, BundledFontFamilyFaces>>;
-/**
- * The only style a bundled or aliased family can be rendered in. There is no italic file in
- * `public/fonts` for any of them, so an italic request against one has no bytes behind it: the
- * browser would slant the upright face, which is neither the typeface the author asked for nor
- * reproducible across engines. A real italic comes from a sealed brand font asset.
- */
+/** The default style of a bundled face when its declaration omits style. */
 export declare const BUNDLED_FONT_STYLE: "normal";
 /** The files behind a bundled or aliased family, or `undefined` when nothing ships for it. */
 export declare function bundledFontFamilyFaces(family: string): BundledFontFamilyFaces | undefined;
@@ -82,8 +78,7 @@ export declare function bundledFontFamilyFaces(family: string): BundledFontFamil
 export declare function bundledFaceCoversWeight(face: BundledFontFace, weight: number): boolean;
 /**
  * Whether bytes ship for exactly this (family, weight, style). This is the whole bundled-face
- * rule: the family must be bundled or aliased, the style must be upright because no italic file
- * exists, and some file must declare the weight.
+ * rule: some bundled or aliased file must declare both the requested weight and style.
  */
 export declare function bundledFontFaceExists(family: string, weight: number, style: "normal" | "italic"): boolean;
 /** The weights a bundled family covers, phrased for an error message ("400-900", "400, 700"). */
@@ -177,10 +172,9 @@ export interface VendoredFontCatalogEntry {
         readonly max: number;
     }>;
     /**
-     * The styles bytes exist for. Always `["normal"]`: no bundled or aliased family ships an
-     * italic file, so `fontStyle: "italic"` over one is refused rather than slanted.
+     * The styles bytes exist for; unsupported styles are refused rather than synthesized.
      */
-    readonly styles: readonly ["normal"];
+    readonly styles: readonly ("normal" | "italic")[];
     /** The weights a caption is drawn at when the style names none. */
     readonly captionDefaults: CaptionFaceDefaults;
     /**

package/dist/_members/composition/fonts/captionFaces.d.ts

@@ -261,8 +261,7 @@ export declare const CAPTION_WEIGHT_CHOICES: readonly number[];
  */
 export declare function captionWeightChoices(stack: string | undefined): readonly number[];
 /**
- * The styles an editing surface may offer for a caption font stack. Every bundled and aliased
- * family is upright-only, so italic is offered only for a stack whose face comes from the brand
- * kit's sealed font manifest.
+ * The styles an editing surface may offer for a caption font stack, derived from bundled
+ * face declarations or deferred to a custom brand font manifest.
  */
 export declare function captionStyleChoices(stack: string | undefined): readonly ("normal" | "italic")[];

package/dist/_members/composition/ops/captionOps.d.ts

@@ -0,0 +1,11 @@
+import type { CaptionLayout, CaptionSegment, CaptionStyle } from '../validators/index.js';
+import type { OpsSet } from './types.js';
+/** Caption-channel edits share one mutation boundary and preserve the existing style/depth semantics. */
+export declare function createCaptionOps(set: OpsSet): {
+    setCaptionStyle: (style: CaptionStyle) => void;
+    setCaptionLayouts: (layouts: CaptionLayout[]) => void;
+    setCaptionDepth: (zPlane: "front" | "behind-subject") => void;
+    setCaptions: (segments: CaptionSegment[], style?: CaptionStyle, derivedFrom?: {
+        clipId: string;
+    }) => void;
+};

package/dist/_members/composition/ops/compositionOps.d.ts

@@ -1,9 +1,28 @@
-import type { CaptionSegment, CaptionStyle, Format, Marker, PerClipEffect, ReframeSegment, TimelineClip, Track } from '../validators/index.js';
+import type { Format, Marker, PerClipEffect, ReframeSegment, TimelineClip, Track } from '../validators/index.js';
 import type { ClipPropertyUpdates, OpsGet, OpsSet } from './types.js';
 import type { TimelineEntity } from '../timeline/plan.js';
 import { type TrackKind } from './compositionOps.shared.js';
 export { findClipById, findMarkerById, findOrCreateTrackByKind, findTrackContainingClipId, type TrackKind, } from './compositionOps.shared.js';
 export declare function createCompositionOps(get: OpsGet, set: OpsSet): {
+    ripple: (time: number, amount: number) => void;
+    setFormat: (next: {
+        aspectRatio: Format["aspectRatio"];
+        fps?: Format["fps"];
+        resolution?: Format["resolution"];
+        platform?: Format["platform"];
+    }) => void;
+    addTrack: (kind: Track["kind"], name?: string, id?: string) => void;
+    removeTrack: (trackId: string) => void;
+    updateTrack: (trackId: string, updates: Partial<Pick<Track, "name" | "enabled" | "volume">>) => void;
+    reorderTracks: (fromIndex: number, toIndex: number) => void;
+    moveClipToTrack: (clipId: string, targetTrackId: string, newStartTime?: number) => void;
+    duplicateClip: (id: string) => string | undefined;
+    setCaptionStyle: (style: import("../index.js").CaptionStyle) => void;
+    setCaptionLayouts: (layouts: import("../index.js").CaptionLayout[]) => void;
+    setCaptionDepth: (zPlane: "front" | "behind-subject") => void;
+    setCaptions: (segments: import("../index.js").CaptionSegment[], style?: import("../index.js").CaptionStyle, derivedFrom?: {
+        clipId: string;
+    }) => void;
     addClip: (clip: TimelineClip, options?: {
         newTrack?: boolean;
         newTrackId?: string;
@@ -41,23 +60,5 @@ export declare function createCompositionOps(get: OpsGet, set: OpsSet): {
     removeExcludedRange: (clipId: string, rangeIdx: number) => void;
     setCropIntents: (clipId: string, segments: ReframeSegment[] | null) => void;
     setEffects: (clipId: string, effects: PerClipEffect[]) => void;
-    setCaptionStyle: (style: CaptionStyle) => void;
-    setCaptionDepth: (zPlane: "front" | "behind-subject") => void;
-    setCaptions: (segments: CaptionSegment[], style?: CaptionStyle, derivedFrom?: {
-        clipId: string;
-    }) => void;
-    ripple: (time: number, amount: number) => void;
-    setFormat: (next: {
-        aspectRatio: Format["aspectRatio"];
-        fps?: Format["fps"];
-        resolution?: Format["resolution"];
-        platform?: Format["platform"];
-    }) => void;
-    addTrack: (kind: Track["kind"], name?: string, id?: string) => void;
-    removeTrack: (trackId: string) => void;
-    updateTrack: (trackId: string, updates: Partial<Pick<Track, "name" | "enabled" | "volume">>) => void;
-    reorderTracks: (fromIndex: number, toIndex: number) => void;
-    moveClipToTrack: (clipId: string, targetTrackId: string, newStartTime?: number) => void;
-    duplicateClip: (id: string) => string | undefined;
 };
 export type CompositionOps = ReturnType<typeof createCompositionOps>;