@peekling/runtime 0.1.0 → 0.1.2

package/dist/runtime.d.ts

@@ -1,6 +1,33 @@
+import { type CharacterIndicator } from "./interaction.js";
+import { type CharacterRendererFactory } from "./renderer.js";
 import type { RuntimeStyleAsset } from "./styles.js";
-import { type DiagnosticRecord, type EmitResult, type HostContent, type HostBindings, type NativeManifest, type NormalizedPack, type Point, type Plan, type OverrideHandle, type OverrideInput, type SurfaceTheme } from "./types.js";
+import { type DiagnosticRecord, type EmitResult, type HostContent, type HostBindings, type NativeManifest, type NormalizedPack, type Point, type PeeklingPreset, type Plan, type OverrideHandle, type OverrideInput, type SurfaceTheme, type TargetAnchor } from "./types.js";
 export type PeeklingPosition = "bottom-left" | "bottom-right" | "center" | Readonly<Point>;
+export type PeeklingPressAction = "toggle-content" | "show-content" | "hide-content" | "emit" | "none";
+export interface PeeklingInteractionOptions {
+    /** Defaults to toggle-content. Setting pressEvent defaults this to emit. */
+    press?: PeeklingPressAction;
+    /** Bounded application Event emitted by the emit press action. */
+    pressEvent?: string;
+    drag?: boolean;
+    throw?: boolean;
+    dragState?: string;
+    riseState?: string;
+    fallState?: string;
+    landState?: string;
+    gravity?: number;
+    maxThrowSpeed?: number;
+    bounce?: number;
+    floorInset?: number;
+    label?: string;
+    contentInitiallyHidden?: boolean;
+    clearIndicatorOnPress?: boolean;
+    catchTarget?: string;
+    catchAnchor?: TargetAnchor;
+    catchMargin?: number;
+    catchEvent?: string;
+}
+export type PeeklingIndicator = CharacterIndicator;
 export interface PeeklingOptions {
     /** Serializable options contract version. Defaults to 1. */
     format?: 1;
@@ -15,6 +42,14 @@ export interface PeeklingOptions {
     styles?: RuntimeStyleAsset;
     /** Host-owned immutable Plan. Packs remain data-only. */
     plan?: Plan;
+    /** Named simple behavior compiled into the same canonical Plan. */
+    preset?: PeeklingPreset;
+    /** Host-approved element geometry available to target-aware motion. */
+    targets?: Readonly<Record<string, string>>;
+    /** Direct manipulation is enabled by default. Set false to remove the hit target. */
+    interaction?: false | PeeklingInteractionOptions;
+    /** Optional notification state rendered on the owned character hit target. */
+    indicator?: PeeklingIndicator;
     /** Host-owned accessible text and links referenced by plan contentId values. */
     content?: HostContent;
     /** Property-only host surface mounts. */
@@ -64,21 +99,32 @@ export interface PeeklingInstance {
     override(value: OverrideInput): OverrideHandle;
     pause(): void;
     resume(): void;
+    /** Re-resolve configured target selectors after host layout changes. */
+    refreshTargets(): void;
+    setIndicator(indicator: PeeklingIndicator | null): void;
+    /** Show or hide every content surface owned by this character. */
+    setContentVisible(visible: boolean): boolean;
+    /** Toggle every content surface owned by this character. */
+    toggleContent(): boolean;
     destroy(): void;
 }
 /** Package-internal implementation. It is not a supported import. */
 export declare class PeeklingRuntime implements PeeklingInstance {
     #private;
-    static hatch(input: PeeklingHatchInput | PeeklingOptions): PeeklingRuntime;
+    static hatch(input: PeeklingHatchInput | PeeklingOptions, rendererFactory?: CharacterRendererFactory): PeeklingRuntime;
     /** Package-internal presentation update used only by the Web Component. */
     updateComponentName(value: PeeklingOptions["name"]): boolean;
     readonly ready: Promise<this>;
     readonly finished: Promise<PeeklingFinishResult>;
-    constructor(options?: PeeklingOptions);
+    constructor(options?: PeeklingOptions, rendererFactory?: CharacterRendererFactory);
     emit(name: string, payload?: unknown): EmitResult;
     override(value: OverrideInput): OverrideHandle;
     pause(): void;
     resume(): void;
+    refreshTargets(): void;
+    setIndicator(indicator: PeeklingIndicator | null): void;
+    setContentVisible(visible: boolean): boolean;
+    toggleContent(): boolean;
     destroy(): void;
 }
 /** Create one independently owned companion instance. */

package/dist/runtime.d.ts.map

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