@cueframe/kernel 0.2.1 → 0.2.3

package/dist/_members/mcp/sceneShotExample.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The canonical world-object scene example an agent can copy, plus the prose that explains where its
+ * placeholder media ids come from.
+ *
+ * NOTHING HERE IS HAND-INLINED. Both `scene` payloads are the canonical `SCENE_SHOT_EXAMPLES`
+ * specs published by `@cueframe/composition/scene`, copied verbatim into
+ * `./generated/sceneContract.js` by `packages/mcp/scripts/generate-scene-contract.ts` and gated by
+ * `pnpm check:api-consumer-drift`. `@cueframe/mcp` cannot depend on `@cueframe/composition`, so a
+ * copy is unavoidable; a *generated* copy cannot drift silently the way an inlined one can.
+ *
+ * Two tests hold the copy to the contract from both sides:
+ * `packages/authoring/src/scene/discoveryExample.test.ts` — the package that CAN import
+ * composition — parses every spec with `parseSceneShotSpecV2`, checks it against the generated
+ * `@cueframe/composition/scene/schema.json`, and asserts it still deep-equals the canonical
+ * example; `packages/mcp/src/sceneShot.test.ts` re-parses the whole batch through the GENERATED
+ * `applyCompositionBody` zod, i.e. the exact schema this server puts on the wire.
+ *
+ * To refresh after a contract change: run `pnpm generate:api-consumers`.
+ */
+export { SCENE_SHOT_EXAMPLE_SHOTS, SCENE_SHOT_WORLD_OBJECT_BODY, } from './generated/sceneContract.js';
+/** Where the placeholder media ids in the example come from. */
+export declare const SCENE_SHOT_ASSET_PROVENANCE: string;

package/dist/_members/media-model/api.d.ts

@@ -174,6 +174,7 @@ export declare const MediaItem: z.ZodObject<{
         video: "video";
         audio: "audio";
         image: "image";
+        data: "data";
     }>;
     filename: z.ZodString;
     mimeType: z.ZodString;

package/dist/_members/media-model/media-kind.d.ts

@@ -1,4 +1,4 @@
-export type MediaKind = "video" | "audio" | "image" | "opaque";
+export type MediaKind = "video" | "audio" | "image" | "data" | "opaque";
 export declare const IMAGE_CONTENT_TYPES: readonly ["image/png", "image/jpeg", "image/webp"];
 export declare const ALLOWED_CONTENT_TYPES: readonly ["video/mp4", "video/quicktime", "video/x-matroska", "video/webm", "audio/mpeg", "audio/wav", "audio/x-wav", "audio/mp4", "audio/aac", "image/png", "image/jpeg", "image/webp", "image/gif", "image/svg+xml", "application/json", "font/ttf", "font/otf", "font/woff", "font/woff2"];
 export type AllowedContentType = (typeof ALLOWED_CONTENT_TYPES)[number];

package/dist/_members/media-model/testing/mediaStoreContract.d.ts

@@ -1,4 +1,4 @@
-export type ContractPoolKind = 'video' | 'audio' | 'image';
+export type ContractPoolKind = 'video' | 'audio' | 'image' | 'data';
 export interface ContractPoolItem {
     id: string;
     name: string;

package/dist/_members/primitives/effects/index.d.ts

@@ -7,6 +7,7 @@ export { Particles } from './particles/index.js';
 export { PulsingIndicator } from './pulsing-indicator/index.js';
 export { SpotlightCard } from './spotlight-card/index.js';
 export { SpringPopIn } from './spring-pop-in/index.js';
+export { StageCameraEffect, laneDepths } from './stage-camera/index.js';
 export { SuccessConfetti } from './success-confetti/index.js';
 export { Vignette } from './vignette/index.js';
 export declare const catalog: Catalog;

package/dist/_members/primitives/effects/stage-camera/config.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import type { PrimitiveMeta } from '../../lib/types.js';
+declare const paramsSchema: z.ZodObject<{
+    move: z.ZodDefault<z.ZodEnum<{
+        static: "static";
+        "dolly-in": "dolly-in";
+        "dolly-out": "dolly-out";
+        drift: "drift";
+        "tilt-reveal": "tilt-reveal";
+        orbit: "orbit";
+    }>>;
+    fov: z.ZodDefault<z.ZodNumber>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    easing: z.ZodDefault<z.ZodEnum<{
+        emphasis: "emphasis";
+        playful: "playful";
+        none: "none";
+        exit: "exit";
+        entrance: "entrance";
+        cross: "cross";
+        drama: "drama";
+    }>>;
+    from: z.ZodOptional<z.ZodObject<{
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+        z: z.ZodOptional<z.ZodNumber>;
+        rotX: z.ZodOptional<z.ZodNumber>;
+        rotY: z.ZodOptional<z.ZodNumber>;
+        rotZ: z.ZodOptional<z.ZodNumber>;
+        fov: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    to: z.ZodOptional<z.ZodObject<{
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+        z: z.ZodOptional<z.ZodNumber>;
+        rotX: z.ZodOptional<z.ZodNumber>;
+        rotY: z.ZodOptional<z.ZodNumber>;
+        rotZ: z.ZodOptional<z.ZodNumber>;
+        fov: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    focus: z.ZodOptional<z.ZodObject<{
+        z: z.ZodNumber;
+        range: z.ZodNumber;
+        maxBlur: z.ZodNumber;
+    }, z.core.$strip>>;
+    layerDepth: z.ZodDefault<z.ZodNumber>;
+}, z.core.$loose>;
+type Params = z.infer<typeof paramsSchema>;
+export declare const config: PrimitiveMeta<Params>;
+export {};

package/dist/_members/primitives/effects/stage-camera/index.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import { type CameraMove, type FocusSpec, type StageCamera } from '../../../animate/index.js';
+import { type EasingIntent } from '../../lib/easings.js';
+export interface StageCameraEffectProps {
+    move?: CameraMove;
+    fov?: number;
+    amount?: number;
+    easing?: EasingIntent;
+    from?: Partial<StageCamera>;
+    to?: Partial<StageCamera>;
+    focus?: FocusSpec;
+    layerDepth?: number;
+    /** Wrap protocol (render-entry WrapEffects). */
+    active?: boolean;
+    effectFrame?: number;
+    effectDurationInFrames?: number;
+    style?: React.CSSProperties;
+    /** Stage size; defaults to the video frame. */
+    width?: number;
+    height?: number;
+    children?: React.ReactNode;
+}
+/** z for each child: tagged lanes are spaced by `layerDepth`, the front-most lane at 0. */
+export declare function laneDepths(children: React.ReactNode, layerDepth: number): number[];
+/**
+ * Uniform scale that cancels the perspective foreshortening of a lane at depth `z`: a layer
+ * there projects at `P / (P - z)`, so `(P - z) / P` restores the size it would have at z=0.
+ * Lanes therefore stay full-bleed at the rest camera and parallax only when the camera moves.
+ */
+export declare function laneScale(z: number, fov: number, height: number): number;
+export declare const StageCameraEffect: React.FC<StageCameraEffectProps>;

package/dist/_members/primitives/layouts/flex-layout/config.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import type { PrimitiveMeta } from '../../lib/types.js';
+declare const paramsSchema: z.ZodObject<{
+    direction: z.ZodDefault<z.ZodEnum<{
+        column: "column";
+        row: "row";
+    }>>;
+    gap: z.ZodDefault<z.ZodNumber>;
+    padding: z.ZodDefault<z.ZodNumber>;
+    tracks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+        split: z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+            weight: z.ZodNumber;
+            basis: z.ZodOptional<z.ZodNumber>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            shrink: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>>;
+        weight: z.ZodNumber;
+        basis: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        shrink: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        weight: z.ZodNumber;
+        basis: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        shrink: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>>>;
+    tracksEnd: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+        split: z.ZodArray<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+            weight: z.ZodNumber;
+            basis: z.ZodOptional<z.ZodNumber>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            shrink: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>>;
+        weight: z.ZodNumber;
+        basis: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        shrink: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        weight: z.ZodNumber;
+        basis: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        shrink: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>>>;
+    fits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        mode: z.ZodEnum<{
+            position: "position";
+            stretch: "stretch";
+            contain: "contain";
+            cover: "cover";
+            scale: "scale";
+            matte: "matte";
+        }>;
+        aspect: z.ZodOptional<z.ZodNumber>;
+        size: z.ZodOptional<z.ZodObject<{
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, z.core.$strip>>;
+        anchor: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strict>>>;
+    outline: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$loose>;
+type Params = z.infer<typeof paramsSchema>;
+export declare const config: PrimitiveMeta<Params>;
+export {};

package/dist/_members/primitives/layouts/flex-layout/index.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { type FlexLayoutProps } from '../../../animate/index.js';
+export { buildTree, unionTracks, weightsAt, type FlexTrack, type FlexTrackSpec, type FlexLayoutProps, } from '../../../animate/index.js';
+export declare const FlexLayout: React.FC<FlexLayoutProps>;

package/dist/_members/primitives/layouts/index.d.ts

@@ -1,5 +1,6 @@
 import type { Catalog } from '../lib/types.js';
 export { ChatToPreviewLayout } from './chat-to-preview-layout/index.js';
+export { FlexLayout } from './flex-layout/index.js';
 export { InfiniteBentoPan } from './infinite-bento-pan/index.js';
 export { Letterbox } from './letterbox/index.js';
 export { PhotoGrid } from './photo-grid/index.js';

package/dist/_members/primitives/layouts/picture-in-picture/config.d.ts

@@ -3,8 +3,8 @@ import type { PrimitiveMeta } from '../../lib/types.js';
 declare const paramsSchema: z.ZodObject<{
     position: z.ZodDefault<z.ZodEnum<{
         "top-left": "top-left";
-        "top-right": "top-right";
         "bottom-left": "bottom-left";
+        "top-right": "top-right";
         "bottom-right": "bottom-right";
     }>>;
     size: z.ZodDefault<z.ZodNumber>;

package/dist/_members/primitives/lib/frameScale.d.ts

@@ -0,0 +1,4 @@
+/** Pixel values in this catalog were authored against a 1280-wide frame. */
+export declare const FRAME_BASELINE_WIDTH = 1280;
+export declare function frameScale(width: number, baseline?: number): number;
+export declare function useFrameScale(baseline?: number): number;

package/dist/_members/primitives/lib/index.d.ts

@@ -1,6 +1,7 @@
 export type { PrimitiveMeta, PrimitiveCategory, PrimitiveKind, Mood, Example, TokenBinding, PrimitivePreview as PrimitivePreviewMeta, Catalog, } from './types.js';
 export { SOFT, OUT_EXPO, OUT_BACK, OUT_CUBIC, IN_OUT_CUBIC, IN_OUT_QUART, IN_QUART, LINEAR, STEP, EASING_BY_INTENT, type EasingIntent, } from './easings.js';
 export { pick, range, gauss, SeededPRNG } from './seeded-random.js';
+export { frameScale, useFrameScale, FRAME_BASELINE_WIDTH } from './frameScale.js';
 export { resolveTokenValue, applyBrandCascade, resolveParams, isContrastCritical, CONTRAST_CRITICAL_PATHS, ALLOWED_BRAND_PATHS, FROZEN_CORE_PATHS, TIER2B_EXTENSION_PATHS, lintBrandPath, } from './tokens.js';
 export { NEUTRAL_RAMP } from '../../brand-derivation/constants.js';
 export { zodToJsonSchemaFor, zodToDefaults, zodToControls, type ControlConfig, type ControlType, } from './schema.js';

package/dist/_members/primitives/lib/palette.d.ts

@@ -1,33 +1,33 @@
-export declare const BG_DEEP = "#0f0b07";
-export declare const BG = "#14100c";
-export declare const SURFACE = "#1c1611";
-export declare const SURFACE_HI = "#241d16";
-export declare const BORDER = "#2e2620";
-export declare const BORDER_SOFT = "rgba(244,236,224,0.10)";
-export declare const BORDER_STRONG = "#3a3128";
-export declare const TEXT_HI = "#f4ece0";
-export declare const TEXT = "#e4dccf";
-export declare const TEXT_MUTED = "#b8a894";
-export declare const TEXT_FAINT = "#7a6f63";
-export declare const ACCENT = "#f2913c";
-export declare const ACCENT_STRONG = "#e8782b";
-export declare const ACCENT_DEEP = "#b0501c";
-export declare const ACCENT_SOFT = "#ffb38e";
-export declare const SUCCESS = "#7fae7a";
-export declare const SUCCESS_SOFT = "#a7c8a1";
-export declare const DANGER = "#d1685e";
-export declare const WARNING = "#e0a355";
-export declare const BLUE = "#7b93b0";
-export declare const VIOLET = "#9b8bb0";
-export declare const TEAL = "#5fa5a0";
-export declare const SERIES: readonly ["#f2913c", "#5fa5a0", "#7b93b0", "#9b8bb0", "#7fae7a", "#e0a355"];
-export declare const SYN_TEXT = "#e4dccf";
-export declare const SYN_COMMENT = "#7a6f63";
-export declare const SYN_KEYWORD = "#c99ac0";
-export declare const SYN_STRING = "#9cb887";
-export declare const SYN_NUMBER = "#dcae6a";
-export declare const SYN_FN = "#e8934f";
-export declare const SYN_PROP = "#7fa8b0";
+export declare const BG_DEEP = "#050507";
+export declare const BG = "#0b0b0e";
+export declare const SURFACE = "#141418";
+export declare const SURFACE_HI = "#1b1b1f";
+export declare const BORDER = "#26262e";
+export declare const BORDER_SOFT = "rgba(255,255,255,0.08)";
+export declare const BORDER_STRONG = "#34343e";
+export declare const TEXT_HI = "#F5F5F7";
+export declare const TEXT = "#e4e4e9";
+export declare const TEXT_MUTED = "#9b9ba6";
+export declare const TEXT_FAINT = "#62626d";
+export declare const ACCENT = "#6f7dff";
+export declare const ACCENT_STRONG = "#5566f2";
+export declare const ACCENT_DEEP = "#3d4ac7";
+export declare const ACCENT_SOFT = "#a7b0ff";
+export declare const SUCCESS = "#5ec48a";
+export declare const SUCCESS_SOFT = "#9ddcb8";
+export declare const DANGER = "#ef6a5e";
+export declare const WARNING = "#e9b84a";
+export declare const BLUE = "#6aa6ff";
+export declare const VIOLET = "#a48cff";
+export declare const TEAL = "#4fc8c4";
+export declare const SERIES: readonly ["#6f7dff", "#4fc8c4", "#6aa6ff", "#a48cff", "#5ec48a", "#e9b84a"];
+export declare const SYN_TEXT = "#e4e4e9";
+export declare const SYN_COMMENT = "#62626d";
+export declare const SYN_KEYWORD = "#c792ea";
+export declare const SYN_STRING = "#9ece6a";
+export declare const SYN_NUMBER = "#f0b46a";
+export declare const SYN_FN = "#82aaff";
+export declare const SYN_PROP = "#7dcfff";
 export declare const MAC_RED = "#ff5f57";
 export declare const MAC_YELLOW = "#febc2e";
 export declare const MAC_GREEN = "#28c840";

package/dist/_members/primitives/lib/text/contrast.d.ts

@@ -2,7 +2,8 @@ export interface ContrastResult {
     textColor: string;
     textShadow: string;
 }
-export declare const FLOOR_TEXT = "#F7F2EA";
+/** The house text floor. Derived so it can never drift from the palette's primary text colour. */
+export declare const FLOOR_TEXT = "#F5F5F7";
 export declare const FLOOR_SHADOW = "0 1px 6px rgba(0,0,0,0.55)";
 export declare function resolveContrast(opts?: {
     brandTextOnMedia?: string;

package/dist/_members/primitives/lib/text/spec.d.ts

@@ -1,11 +1,3 @@
-export interface TextTypography {
-    fontFamily: string;
-    fontSizePct: number;
-    fontWeight: number;
-    fontStyle?: 'normal' | 'italic';
-    letterSpacing?: number;
-    textTransform?: 'none' | 'uppercase' | 'capitalize';
-}
 export interface TextRecolor {
     from: string;
     to: string;

package/dist/_members/primitives/lib/types.d.ts

@@ -32,6 +32,8 @@ export interface PrimitiveMeta<P = any> {
     kind: PrimitiveKind;
     version: string;
     effectPlacement?: 'wrap' | 'overlay';
+    /** Rendering capability the primitive needs beyond DOM. The render lane picks a GL backend from it. */
+    graphics?: 'webgl';
     intent: string;
     description: string;
     useWhen: string;

package/dist/_members/primitives/scenes/device-showcase/config.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import type { PrimitiveMeta } from '../../lib/types.js';
+declare const paramsSchema: z.ZodObject<{
+    device: z.ZodDefault<z.ZodEnum<{
+        laptop: "laptop";
+        phone: "phone";
+    }>>;
+    screenSrc: z.ZodOptional<z.ZodString>;
+    move: z.ZodDefault<z.ZodEnum<{
+        static: "static";
+        "dolly-in": "dolly-in";
+        "dolly-out": "dolly-out";
+        drift: "drift";
+        "tilt-reveal": "tilt-reveal";
+        orbit: "orbit";
+    }>>;
+    fov: z.ZodDefault<z.ZodNumber>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    easing: z.ZodDefault<z.ZodEnum<{
+        emphasis: "emphasis";
+        playful: "playful";
+        none: "none";
+        exit: "exit";
+        entrance: "entrance";
+        cross: "cross";
+        drama: "drama";
+    }>>;
+    finish: z.ZodDefault<z.ZodString>;
+    background: z.ZodDefault<z.ZodString>;
+    accentColor: z.ZodDefault<z.ZodString>;
+    openAngle: z.ZodDefault<z.ZodNumber>;
+    lighting: z.ZodDefault<z.ZodEnum<{
+        soft: "soft";
+        key: "key";
+        rim: "rim";
+    }>>;
+    speed: z.ZodDefault<z.ZodNumber>;
+}, z.core.$loose>;
+type Params = z.infer<typeof paramsSchema>;
+export declare const config: PrimitiveMeta<Params>;
+export {};

package/dist/_members/primitives/scenes/device-showcase/index.d.ts

@@ -0,0 +1,36 @@
+import { type CameraMove, type DeviceKind } from '../../../animate/index.js';
+import { type EasingIntent } from '../../lib/easings.js';
+export interface DeviceShowcaseProps {
+    device?: 'laptop' | 'phone';
+    screenSrc?: string;
+    move?: CameraMove;
+    fov?: number;
+    amount?: number;
+    easing?: EasingIntent;
+    finish?: string;
+    background?: string;
+    accentColor?: string;
+    openAngle?: number;
+    lighting?: 'soft' | 'key' | 'rim';
+    speed?: number;
+}
+/** Body width of the device in px: the laptop reads as a hero, the phone as an object in space. */
+export declare function deviceBodyWidth(kind: DeviceKind, frameWidth: number): number;
+/** Y offset of the device group in px. The laptop rides a touch high so the open lid centres. */
+export declare function deviceGroupY(kind: DeviceKind, frameHeight: number): number;
+/**
+ * Height of StudioRig's shadow floor: the device's own bottom edge.
+ *
+ * It has to come from the device's geometry, never from the frame height. The device is sized off
+ * the frame *width*, so a height-derived floor drifts the moment the aspect is not 16:9 — 365px of
+ * float for the laptop at 9:16, 585px for the phone — and a floating floor slides the contact
+ * shadow out from under the device and into the open frame as a detached band. That is exactly the
+ * unlit-placeholder tell this scene exists to kill.
+ *
+ * The laptop's underside comes from `laptopLayout`, the one statement of that layout, which the
+ * mesh and the scene renderer also read: this used to be a hand-copy of the same arithmetic, and a
+ * change to the mesh would have moved the device off this floor without a word. The phone's shell
+ * is centred on the group, so its underside is simply -h/2.
+ */
+export declare function deviceFloorY(kind: DeviceKind, frameWidth: number, frameHeight: number): number;
+export declare function DeviceShowcase({ device, screenSrc, move, fov, amount, easing, finish, background, accentColor, openAngle, lighting, speed, }: DeviceShowcaseProps): import("react").JSX.Element;

package/dist/_members/primitives/scenes/hero-device-assemble/config.d.ts

@@ -6,6 +6,7 @@ declare const paramsSchema: z.ZodObject<{
         laptop: "laptop";
         phone: "phone";
     }>>;
+    screenSrc: z.ZodOptional<z.ZodString>;
     accentColor: z.ZodDefault<z.ZodString>;
     speed: z.ZodDefault<z.ZodNumber>;
     className: z.ZodOptional<z.ZodString>;

package/dist/_members/primitives/scenes/hero-device-assemble/index.d.ts

@@ -1,8 +1,9 @@
 export interface HeroDeviceAssembleProps {
     assembleStart?: number;
     device?: "laptop" | "phone";
+    screenSrc?: string;
     accentColor?: string;
     speed?: number;
     className?: string;
 }
-export declare function HeroDeviceAssemble({ assembleStart, device, accentColor, speed, className, }: HeroDeviceAssembleProps): import("react").JSX.Element;
+export declare function HeroDeviceAssemble({ assembleStart, device, screenSrc, accentColor, speed, className, }: HeroDeviceAssembleProps): import("react").JSX.Element;

package/dist/_members/primitives/scenes/index.d.ts

@@ -6,4 +6,5 @@ export { HeroDeviceAssemble } from './hero-device-assemble/index.js';
 export { PricingTierFocus } from './pricing-tier-focus/index.js';
 export { LandingCodeShowcase } from './landing-code-showcase/index.js';
 export { TerminalToBrowserDeploy } from './terminal-to-browser-deploy/index.js';
+export { DeviceShowcase } from './device-showcase/index.js';
 export declare const catalog: Catalog;

package/dist/_members/primitives/ui-blocks/badge-pop/config.d.ts

@@ -8,8 +8,8 @@ declare const paramsSchema: z.ZodObject<{
     position: z.ZodDefault<z.ZodEnum<{
         center: "center";
         "top-left": "top-left";
-        "top-right": "top-right";
         "bottom-left": "bottom-left";
+        "top-right": "top-right";
         "bottom-right": "bottom-right";
     }>>;
     fontSize: z.ZodDefault<z.ZodNumber>;

package/dist/_members/primitives/ui-blocks/device-mockup-zoom/config.d.ts

@@ -5,6 +5,7 @@ declare const paramsSchema: z.ZodObject<{
         laptop: "laptop";
         phone: "phone";
     }>>;
+    screenSrc: z.ZodOptional<z.ZodString>;
     frameColor: z.ZodDefault<z.ZodString>;
     screenColor: z.ZodDefault<z.ZodString>;
     background: z.ZodDefault<z.ZodString>;

package/dist/_members/primitives/ui-blocks/device-mockup-zoom/index.d.ts

@@ -1,6 +1,7 @@
 import type { ReactNode } from "react";
 export interface DeviceMockupZoomProps {
     children?: ReactNode;
+    screenSrc?: string;
     device?: "laptop" | "phone";
     frameColor?: string;
     screenColor?: string;
@@ -8,4 +9,4 @@ export interface DeviceMockupZoomProps {
     speed?: number;
     className?: string;
 }
-export declare function DeviceMockupZoom({ children, device, frameColor, screenColor, background, speed, className, }: DeviceMockupZoomProps): import("react").JSX.Element;
+export declare function DeviceMockupZoom({ children, screenSrc, device, frameColor, screenColor, background, speed, className, }: DeviceMockupZoomProps): import("react").JSX.Element;

package/dist/_members/primitives/ui-blocks/terminal-simulator/config.d.ts

@@ -4,9 +4,9 @@ declare const paramsSchema: z.ZodObject<{
     lines: z.ZodOptional<z.ZodArray<z.ZodObject<{
         type: z.ZodEnum<{
             error: "error";
+            log: "log";
             success: "success";
             command: "command";
-            log: "log";
         }>;
         text: z.ZodString;
     }, z.core.$loose>>>;

package/dist/_members/primitives/ui-blocks/toast-notification/config.d.ts

@@ -6,8 +6,8 @@ declare const paramsSchema: z.ZodObject<{
     variant: z.ZodDefault<z.ZodEnum<{
         error: "error";
         success: "success";
-        info: "info";
         warning: "warning";
+        info: "info";
     }>>;
     background: z.ZodOptional<z.ZodString>;
     cardColor: z.ZodOptional<z.ZodString>;

package/dist/_members/render-harness/cardAssetAdmission.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cardAssetAdmission.d.ts","sourceRoot":"","sources":["../src/cardAssetAdmission.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA+GzD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAQhE"}
+{"version":3,"file":"cardAssetAdmission.d.ts","sourceRoot":"","sources":["../src/cardAssetAdmission.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA+GzD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAQhE"}

package/dist/_members/render-harness/cardRender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cardRender.d.ts","sourceRoot":"","sources":["../src/cardRender.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AACvD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA6BnG;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,IACtD,QAAQ,GAAG,SAOpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA6C7F"}
+{"version":3,"file":"cardRender.d.ts","sourceRoot":"","sources":["../src/cardRender.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AACvD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA6BnG;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,IACtD,QAAQ,GAAG,SAOpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA0D7F"}

package/dist/_members/render-harness/css-tree-subpaths.d.ts

@@ -0,0 +1,11 @@
+// css-tree exposes these focused entry points, but @types/css-tree only
+// declares its root module. Keep their types tied to that upstream contract.
+declare module 'css-tree/parser' {
+  const parse: typeof import('css-tree').parse;
+  export default parse;
+}
+
+declare module 'css-tree/walker' {
+  const walk: typeof import('css-tree').walk;
+  export default walk;
+}

package/dist/_members/render-harness/extractSegments.d.ts

@@ -11,6 +11,7 @@ interface ClipRange {
 }
 export declare function extractSegments(clips: ClipRange[], sourceFiles: Record<string, string>, opts?: {
     padding?: number;
+    signal?: AbortSignal;
 }): Promise<SegmentResult>;
 export {};
 //# sourceMappingURL=extractSegments.d.ts.map

package/dist/_members/render-harness/extractSegments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractSegments.d.ts","sourceRoot":"","sources":["../src/extractSegments.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,UAAU,SAAS;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,SAAS,EAAE,EAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,aAAa,CAAC,CA2DxB"}
+{"version":3,"file":"extractSegments.d.ts","sourceRoot":"","sources":["../src/extractSegments.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,UAAU,SAAS;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,SAAS,EAAE,EAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAChD,OAAO,CAAC,aAAa,CAAC,CAoExB"}

package/dist/_members/render-harness/imageHeader.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Verified image facts from the bytes themselves: the container the decoder will see and the
+ * dimensions it will decode, read from the PNG IHDR, the JPEG frame header (SOF), or the WebP
+ * VP8 / VP8L / VP8X chunk. Anything else (GIF, SVG, BMP, a truncated file, a JPEG without a
+ * frame header) yields null. No decoder dependency, no pixel work, deterministic.
+ */
+export interface ImageHeader {
+    mimeType: 'image/png' | 'image/jpeg' | 'image/webp';
+    width: number;
+    height: number;
+}
+/** The verified container and decoded dimensions, or null when the bytes are not a v1 scene image. */
+export declare function readImageHeader(bytes: Uint8Array): ImageHeader | null;
+//# sourceMappingURL=imageHeader.d.ts.map

package/dist/_members/render-harness/imageHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageHeader.d.ts","sourceRoot":"","sources":["../src/imageHeader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAqGD,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAErE"}

package/dist/_members/render-harness/index.d.ts

@@ -1,5 +1,7 @@
 export { materializeSources } from './materializeSources.js';
 export type { MaterializeResult } from './materializeSources.js';
+export { createNodeScenePreparationV1 } from './nodeScenePreparation.js';
+export type { NodeScenePreparationV1 } from './nodeScenePreparation.js';
 export { extractSegments } from './extractSegments.js';
 export type { SegmentResult } from './extractSegments.js';
 export { startMediaServer } from './mediaServer.js';
@@ -9,6 +11,10 @@ export type { AssetMap } from './resolveAssets.js';
 export { renderInputAssets, assertNoRemoteRefs, assetSlots, isRemoteUrl, assetUrlKey, } from './renderInputAssets.js';
 export type { AssetRole, AssetRef, AssetSlot } from './renderInputAssets.js';
 export { assertCardHtmlAssetFree } from './cardAssetAdmission.js';
+export { readImageHeader } from './imageHeader.js';
+export type { ImageHeader } from './imageHeader.js';
+export { localHandleReader, verifySceneShotAssetBytes } from './sceneShotAssets.js';
+export type { HandleReader } from './sceneShotAssets.js';
 export { renderCardStill, generateCardRootSource, generateCardEntrySource, buildCardWebpackOverride, CARD_COMPOSITION_ID, CARD_ROOT_FILENAME, CARD_ENTRY_FILENAME, } from './cardRender.js';
 export type { RenderCardStillOpts } from './cardRender.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/_members/render-harness/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACpF,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}