@peekling/runtime 0.1.0

package/dist/tooling-validation.js

@@ -0,0 +1,94 @@
+export function toolingDiagnostic(code, path, detail) {
+    const field = path.slice(path.lastIndexOf(".") + 1);
+    const diagnostic = (message, fix) => ({
+        code,
+        path,
+        message,
+        fix,
+    });
+    switch (code) {
+        case "manifest.selection":
+            return diagnostic("Select an explicit character, packUrl, or Pack", "Set character, packUrl, or pack");
+        case "unknown-field":
+            return diagnostic(`Unknown field ${detail ?? field}`, "Remove this field");
+        case "unsupported-format":
+            return diagnostic("Options format must be 1", "Use format 1");
+        case "invalid-character":
+            return diagnostic("character must be a bounded lowercase ID", "Use a lowercase ID");
+        case "character.unknown":
+            return diagnostic(`Unknown Peekling character: ${detail ?? ""}`.trim(), "Use a character included in the runtime registry");
+        case "out-of-range":
+            return diagnostic("scale must be an integer from 1 through 4", "Use 1 through 4");
+        case "invalid-density":
+            return diagnostic(`${detail ?? field} must be 1, 2, or 4`, "Use 1, 2, or 4");
+        case "incompatible-density":
+            return diagnostic("density cannot exceed maxDensity", "Raise maxDensity or lower density");
+        case "atlas.max-density":
+            return diagnostic(detail === "single"
+                ? "Single atlas density exceeds maxDensity"
+                : "No declared atlas variant is at or below maxDensity", detail === "single"
+                ? "Raise maxDensity or use a lower-density Pack"
+                : "Raise maxDensity or add a matching lower-density atlas variant");
+        case "atlas.override-density":
+            return diagnostic(detail === "single"
+                ? "density must match the single atlas density"
+                : detail === "missing"
+                    ? "atlasUrl with variants requires an explicit density"
+                    : "atlasUrl density must name a declared variant at or below maxDensity", detail === "single"
+                ? "Match the Pack atlas density or remove density"
+                : "Set density to an available atlas variant");
+        case "invalid-name":
+            return diagnostic("name must be true, false, or short plain text", "Use true, false, or 1-80 plain characters");
+        case "invalid-url":
+            return diagnostic(`${detail ?? field} must be a relative path or absolute HTTPS URL`, "Use a relative path or HTTPS URL");
+        case "invalid-position":
+            return diagnostic("position must be a preset or bounded point with finite coordinates from -100000 through 100000", "Use a preset or bounded x and y values");
+        case "invalid-styles":
+            return diagnostic(detail ?? "styles must be an object", "Pass an external stylesheet URL and optional SRI hash");
+        case "invalid-styles-url":
+            return diagnostic("styles.url must be a relative path or absolute HTTPS URL", "Use a relative path or allowed pinned HTTPS URL");
+        case "invalid-styles-integrity":
+            return diagnostic("styles.integrity must be one SRI hash", "Use the release-provided stylesheet SRI value");
+        case "invalid-content":
+            return diagnostic(detail ?? "content is invalid", "Fix the named content surface");
+        case "invalid-bindings":
+            return diagnostic(path === "$.bindings"
+                ? "bindings must be an object"
+                : `${detail ?? field} must be a registry object`, "Pass a bounded mount registry");
+        case "binding-limit":
+            return diagnostic(`${detail ?? field} exceeds 64 entries`, "Reduce the mount registry");
+        case "invalid-binding":
+            return diagnostic("Mount binding is invalid", "Use a bounded ID and function value");
+        case "missing-binding":
+            return diagnostic(`Unknown mount binding ${detail ?? ""}`.trim(), "Register the mount binding");
+        case "invalid-theme":
+            if (path === "$.theme") {
+                return diagnostic("theme must be an object", "Pass theme tokens");
+            }
+            if (["background", "color", "linkColor", "borderColor"].includes(field)) {
+                return diagnostic(`${field} must be transparent or a 3, 4, 6, or 8 digit hex color`, "Use transparent or a supported hex color");
+            }
+            return diagnostic(`${field} is outside its supported range`, "Use the documented CSS pixel range");
+        case "invalid-diagnostics":
+            return diagnostic(path === "$.diagnostics"
+                ? "diagnostics must be an object"
+                : `${detail ?? field} must be boolean`, "Pass bounded diagnostics options");
+        case "invalid-diagnostic-context":
+            return diagnostic(path === "$.diagnostics.context"
+                ? "Diagnostic context must be an object"
+                : "Diagnostic context needs bounded scalars", "Use up to 16 bounded scalar fields");
+        case "diagnostic-context-limit":
+            return diagnostic("Diagnostic context exceeds 16 fields", "Keep up to 16 bounded fields");
+        case "invalid-accessibility":
+            if (path === "$.accessibility") {
+                return diagnostic("accessibility must be an object", "Pass accessibility options");
+            }
+            return field === "announceContent"
+                ? diagnostic("announceContent must be boolean", "Use a boolean")
+                : diagnostic("contentLabel must be short plain text", "Use 1-120 plain characters");
+        case "invalid-callback":
+            return diagnostic(`${detail ?? field} must be a function`, "Pass a JavaScript callback");
+        default:
+            return diagnostic(detail ?? code, "Fix this field");
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,403 @@
+export declare const NATIVE_CELL_SIZE = 32;
+export declare const NATIVE_LOGICAL_SIZES: readonly [32, 64];
+export type NativeLogicalSize = (typeof NATIVE_LOGICAL_SIZES)[number];
+export declare const NATIVE_COLUMNS = 16;
+export declare const NATIVE_DENSITIES: readonly [1, 2, 4];
+export type NativeDensity = (typeof NATIVE_DENSITIES)[number];
+export declare const NATIVE_DIRECTIONS: readonly ["N", "NE", "E", "SE", "S", "SW", "W", "NW"];
+export type Direction = (typeof NATIVE_DIRECTIONS)[number];
+interface StateDefinitionBase {
+    frames: number[];
+    loop: boolean;
+}
+export type StateDefinition = (StateDefinitionBase & {
+    fps: number;
+    durations?: never;
+}) | (StateDefinitionBase & {
+    durations: number[];
+    fps?: never;
+});
+export interface NativeManifest {
+    format: 1;
+    name: string;
+    version: string;
+    license: string;
+    metadata: {
+        title?: string;
+        author?: string;
+        description: string;
+        tags?: string[];
+    };
+    assets: {
+        atlas: {
+            src: string;
+            sha256: string;
+            columns: 16;
+            rows: number;
+            density?: NativeDensity;
+            logicalCellSize?: NativeLogicalSize;
+            sourceCellSize?: number;
+        };
+    } | {
+        atlases: {
+            columns: 16;
+            rows: number;
+            logicalCellSize: NativeLogicalSize;
+            lineage: string;
+            variants: Array<{
+                src: string;
+                density: NativeDensity;
+                sourceCellSize: number;
+                sha256: string;
+            }>;
+        };
+    };
+    states: Record<string, StateDefinition>;
+    capabilities?: {
+        locomotion?: LocomotionCapability;
+    };
+    defaults?: {
+        scale?: number;
+    };
+}
+export interface LocomotionKeyframe {
+    at: number;
+    advance: number;
+    lift: number;
+}
+export interface LocomotionCapability {
+    directions: Record<Direction, string>;
+    motion?: {
+        keyframes: LocomotionKeyframe[];
+    };
+}
+export interface AtlasGeometry {
+    width: number;
+    height: number;
+    byteLength?: number;
+}
+/**
+ * Stable, serializable adapter IR. This is an adapter output contract, not a
+ * character authoring format. Validation is mandatory at the runtime boundary.
+ */
+export interface NormalizedPack {
+    name: string;
+    displayName: string;
+    version: string;
+    license: string;
+    atlas: {
+        src: string;
+        sha256?: string;
+        columns: number;
+        rows: number;
+        cellWidth: number;
+        cellHeight: number;
+        logicalWidth?: number;
+        logicalHeight?: number;
+        density?: NativeDensity;
+        lineage?: string;
+        variants?: ReadonlyArray<{
+            src: string;
+            density: NativeDensity;
+            cellWidth: number;
+            cellHeight: number;
+            sha256: string;
+        }>;
+    };
+    states: Record<string, StateDefinition>;
+    defaultScale: number;
+    directionalStates?: Partial<Record<Direction, string>>;
+    locomotionMotion?: ReadonlyArray<Readonly<LocomotionKeyframe>>;
+    reactionStates?: Readonly<Record<string, string>>;
+    /** Opaque JSON provenance. The engine never interprets this field. */
+    source?: Readonly<Record<string, JsonValue>>;
+}
+export interface Point {
+    x: number;
+    y: number;
+}
+export declare const PLAN_BROWSER_EVENTS: readonly ["pointer.click", "pointer.move", "document.visibility", "window.focus", "window.scroll", "section.visibility", "page.lifecycle"];
+export type PlanBrowserEvent = (typeof PLAN_BROWSER_EVENTS)[number];
+export type PlanEventSource = "browser" | "application";
+export type PlanDisposition = "update" | "replace" | "ignore" | "interrupt";
+export type PlanCapability = "locomotion";
+export type PlanChannel = "motion" | "state" | `surface:${string}`;
+export type PlanEventCoalescing = "latest";
+export type PlanInterruptLifetime = {
+    type: "duration";
+    ms: number;
+} | {
+    type: "event";
+    /** Application Event or discrete browser Event. Continuous observations are rejected. */
+    name: string;
+    timeout?: number;
+};
+type PlanDiscreteCondition = {
+    source: "application";
+    event: string;
+    coalesce?: PlanEventCoalescing;
+} | {
+    source: "browser";
+    event: Exclude<PlanBrowserEvent, "pointer.move" | "section.visibility" | "window.scroll">;
+    coalesce?: never;
+} | {
+    source: "browser";
+    event: "window.scroll";
+    coalesce?: PlanEventCoalescing;
+} | {
+    source: "browser";
+    event: "section.visibility";
+    selector: string;
+    phase: "enter" | "leave";
+    threshold?: number;
+    coalesce?: never;
+};
+type PlanContinuousCondition = {
+    source: "browser";
+    event: "pointer.move";
+    coalesce?: never;
+} | {
+    source: "browser";
+    event: "section.visibility";
+    selector: string;
+    phase: "while-visible";
+    threshold?: number;
+    coalesce?: never;
+};
+export type PlanCondition = PlanDiscreteCondition | PlanContinuousCondition;
+export type PlanStateSelection = {
+    state: string;
+} | {
+    capability: PlanCapability;
+};
+export interface PlanMotionEffect {
+    type: "follow-pointer";
+    speed?: number;
+    arrivalRadius?: number;
+}
+export interface PlanSurfaceOrdering {
+    sessionField: string;
+    revisionField?: string;
+    terminal?: boolean;
+}
+export interface PlanSurfaceEffect {
+    id: string;
+    contentId: string;
+    data?: JsonValue | "event-payload";
+    disposition?: PlanDisposition;
+    ordering?: PlanSurfaceOrdering;
+}
+export interface PlanEffect {
+    channels: readonly PlanChannel[];
+    state?: PlanStateSelection;
+    motion?: PlanMotionEffect;
+    surfaces?: readonly PlanSurfaceEffect[];
+    /** Required bounded ending behavior for a declarative interrupt Effect. */
+    until?: PlanInterruptLifetime;
+}
+interface PlanContinuousEffect {
+    channels: readonly PlanChannel[];
+    state?: PlanStateSelection;
+    motion?: PlanMotionEffect;
+    surfaces?: never;
+    until?: never;
+}
+export interface PlanBaselineSurfaceEffect {
+    id: string;
+    contentId: string;
+    data?: JsonValue;
+    disposition?: Exclude<PlanDisposition, "interrupt">;
+    ordering?: never;
+}
+export interface PlanBaselineEffect {
+    channels: readonly PlanChannel[];
+    state: PlanStateSelection;
+    motion?: PlanMotionEffect;
+    surfaces?: readonly PlanBaselineSurfaceEffect[];
+    until?: never;
+}
+export type PlanRule = {
+    id: string;
+    when: PlanDiscreteCondition;
+    effect: PlanEffect;
+} | {
+    id: string;
+    when: PlanContinuousCondition;
+    effect: PlanContinuousEffect;
+};
+/** Canonical 0.1 Plan input compiled by the bounded runtime compiler. */
+export interface Plan {
+    baseline: PlanBaselineEffect;
+    rules?: readonly PlanRule[];
+}
+export declare const CONTENT_REGIONS: readonly ["top-left", "top-center", "top-right", "bottom"];
+export type ContentRegion = (typeof CONTENT_REGIONS)[number];
+export interface HostSurfaceMountContext {
+    surfaceId: string;
+    contentId: string;
+    region: ContentRegion;
+    root: HTMLElement;
+    data?: JsonValue;
+    signal: AbortSignal;
+    emit(name: string, payload?: unknown): EmitResult;
+}
+export interface HostSurfaceMountResult {
+    /** Optional own data function. Accessor properties are rejected. */
+    update?(data: JsonValue | undefined): void | PromiseLike<void>;
+    /** Required own data function. Accessor properties are rejected. */
+    cleanup(): void | PromiseLike<void>;
+}
+export type HostSurfaceMount = (context: Readonly<HostSurfaceMountContext>) => HostSurfaceMountResult | PromiseLike<HostSurfaceMountResult>;
+export interface HostContentSurfaceFields {
+    title?: string;
+    text?: string;
+    /** Safe label with a semantically validated relative or HTTPS destination. */
+    link?: {
+        label: string;
+        href: string;
+    };
+    mountId?: string;
+    announce?: boolean;
+}
+export type HostContentSurface = HostContentSurfaceFields & ({
+    title: string;
+} | {
+    text: string;
+} | {
+    link: {
+        label: string;
+        href: string;
+    };
+} | {
+    mountId: string;
+});
+export interface HostBindings {
+    mounts?: Readonly<Record<string, HostSurfaceMount>>;
+}
+export interface SurfaceTheme {
+    /** Lowercase `transparent` or a 3, 4, 6, or 8 digit hex color. */
+    background?: "transparent" | `#${string}`;
+    color?: "transparent" | `#${string}`;
+    linkColor?: "transparent" | `#${string}`;
+    borderColor?: "transparent" | `#${string}`;
+    radius?: number;
+    width?: number;
+    padding?: number;
+}
+export type DiagnosticSeverity = "debug" | "info" | "warning" | "error";
+export interface DiagnosticRecord {
+    code: string;
+    severity: DiagnosticSeverity;
+    message: string;
+    phase: "config" | "event" | "override" | "trigger" | "render" | "lifecycle" | "internal";
+    sequence: number;
+    timestamp: number;
+    instanceId: string;
+    overrideId?: string;
+    eventId?: number;
+    metadata?: Readonly<Record<string, string | number | boolean>>;
+    context?: Readonly<Record<string, string | number | boolean>>;
+    cause?: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+}
+export interface EmitResult {
+    accepted: boolean;
+    id?: number;
+    coalesced?: boolean;
+    reason?: "invalid-name" | "invalid-payload" | "queue-full" | "hidden" | "destroyed" | "not-ready";
+}
+export type OverrideLifetime = {
+    type: "duration";
+    ms: number;
+} | {
+    type: "event";
+    name: string;
+    timeout?: number;
+} | {
+    type: "manual";
+    maxMs?: number;
+};
+export interface OverrideInput {
+    effect: PlanEffect;
+    until?: OverrideLifetime;
+    mode?: "reject" | "replace";
+}
+export type OverrideCompletionReason = "event" | "timeout" | "cancelled" | "replaced" | "rejected" | "conflict" | "overflow" | "dismissed" | "destroyed";
+export type OverrideStatus = "active" | "finished" | "rejected";
+export interface OverrideResult {
+    id: string;
+    reason: OverrideCompletionReason;
+}
+export interface OverrideHandle {
+    id: string;
+    readonly status: OverrideStatus;
+    finished: Promise<OverrideResult>;
+    cancel(): void;
+}
+export type HostContentPrimitive = string | HostContentSurface;
+type HostContentRegionMap = Readonly<Partial<Record<ContentRegion, HostContentPrimitive>>>;
+export type HostContentItem = HostContentRegionMap & {
+    [Region in ContentRegion]: Readonly<Record<Region, HostContentPrimitive>>;
+}[ContentRegion];
+export type HostContent = Readonly<Record<string, HostContentItem>>;
+export interface SectionSnapshot {
+    ratio: number;
+    previousRatio: number;
+}
+export interface ReactionEvent {
+    id: number;
+    source: PlanEventSource;
+    name: string;
+    at: number;
+    payload?: JsonValue;
+}
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export interface World {
+    now: number;
+    pointer?: Point;
+    position: Point;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    lastActivityAt: number;
+    reaction?: ReactionEvent;
+    reducedMotion: boolean;
+    pageVisible?: boolean;
+    sections?: Readonly<Record<string, SectionSnapshot>>;
+}
+export interface MotionRequest {
+    x: number;
+    y: number;
+    speed: number;
+    maxDistance?: number;
+}
+export interface BehaviorRequest {
+    state?: string;
+    capability?: PlanCapability;
+    motion?: MotionRequest;
+    lock?: number;
+    reactionId?: number;
+    contentId?: string;
+    content?: HostContentItem;
+    contentKey?: string;
+    contentData?: JsonValue;
+    surfaces?: readonly SurfacePresentation[];
+}
+export interface SurfacePresentation {
+    id: string;
+    channel: `surface:${string}`;
+    contentId: string;
+    data?: JsonValue;
+    key: string;
+}
+export interface ResolvedState {
+    name: string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,29 @@
+export const NATIVE_CELL_SIZE = 32;
+export const NATIVE_LOGICAL_SIZES = [32, 64];
+export const NATIVE_COLUMNS = 16;
+export const NATIVE_DENSITIES = [1, 2, 4];
+export const NATIVE_DIRECTIONS = [
+    "N",
+    "NE",
+    "E",
+    "SE",
+    "S",
+    "SW",
+    "W",
+    "NW",
+];
+export const PLAN_BROWSER_EVENTS = [
+    "pointer.click",
+    "pointer.move",
+    "document.visibility",
+    "window.focus",
+    "window.scroll",
+    "section.visibility",
+    "page.lifecycle",
+];
+export const CONTENT_REGIONS = [
+    "top-left",
+    "top-center",
+    "top-right",
+    "bottom",
+];

package/dist/visibility.d.ts

@@ -0,0 +1,12 @@
+import { type RuntimeStyleAsset } from "./styles.js";
+export type PeeklingHideDuration = "10-minutes" | "1-hour" | "until-tomorrow" | "session" | "forever";
+type VisibilityListener = (hidden: boolean | null) => void;
+export declare function registerSiteVisibility(document: Document, window: Window, listener: VisibilityListener, styles: RuntimeStyleAsset): {
+    unregister(): void;
+    ready: Promise<void>;
+};
+export declare function hidePeekling(duration: PeeklingHideDuration, document?: Document, window?: Window): void;
+export declare function showPeekling(document?: Document, window?: Window): void;
+export declare function isPeeklingHidden(window?: Window): boolean;
+export {};
+//# sourceMappingURL=visibility.d.ts.map

package/dist/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../src/visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAGrB,MAAM,MAAM,oBAAoB,GAC9B,YAAY,GAAG,QAAQ,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAqBrE,KAAK,kBAAkB,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;AA2W3D,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,iBAAiB,GACxB;IAAE,UAAU,IAAI,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAO9C;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,GAAE,QAA8B,EACxC,MAAM,GAAE,MAA0B,GACjC,IAAI,CAQN;AAED,wBAAgB,YAAY,CAC1B,QAAQ,GAAE,QAA8B,EACxC,MAAM,GAAE,MAA0B,GACjC,IAAI,CAQN;AAED,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,MAA0B,GAAG,OAAO,CAM5E"}