@hypertools/sdk 0.1.0

package/dist/frame/wrapper-app/components/CanvasSizeWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasSizeWidget.d.ts","sourceRoot":"","sources":["../../../../src/frame/wrapper-app/components/CanvasSizeWidget.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAwBnD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EA2OpC,CAAC"}

package/dist/frame/wrapper-app/components/ControlsPanel.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { ControlsPanelProps } from '../types';
+/**
+ * ControlsPanel - React wrapper for Tweakpane controls
+ *
+ * This component creates a container for the existing HypertoolControls
+ * (Tweakpane) to mount into. It manages the lifecycle of the controls
+ * and forwards all changes to the parent component.
+ */
+export declare const ControlsPanel: React.FC<ControlsPanelProps>;
+//# sourceMappingURL=ControlsPanel.d.ts.map

package/dist/frame/wrapper-app/components/ControlsPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlsPanel.d.ts","sourceRoot":"","sources":["../../../../src/frame/wrapper-app/components/ControlsPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAyPtD,CAAC"}

package/dist/frame/wrapper-app/components/ExportWidget.d.ts

@@ -0,0 +1,16 @@
+interface ExportWidgetProps {
+    getContainer: () => HTMLElement | null;
+    filename?: string;
+    useCanvasCapture?: boolean;
+}
+/**
+ * ExportWidget - Export controls UI and logic component
+ *
+ * This component manages:
+ * - UI: Screenshot, recording, and download buttons
+ * - Logic: Capturing PNG images, recording videos, downloading files
+ * - State: Canvas availability detection and all capture/recording state
+ */
+export declare const ExportWidget: React.FC<ExportWidgetProps>;
+export {};
+//# sourceMappingURL=ExportWidget.d.ts.map

package/dist/frame/wrapper-app/components/ExportWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportWidget.d.ts","sourceRoot":"","sources":["../../../../src/frame/wrapper-app/components/ExportWidget.tsx"],"names":[],"mappings":"AAGA,UAAU,iBAAiB;IACzB,YAAY,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAuQpD,CAAC"}

package/dist/frame/wrapper-app/components/ResizeHandles.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+interface ResizeHandlesProps {
+    canvasWidth: number;
+    canvasHeight: number;
+    scale: number;
+    onResize: (width: number, height: number) => void;
+}
+/**
+ * ResizeHandles - Drag handles for resizing the canvas container
+ *
+ * Provides 8 resize handles with complete resize logic:
+ * - 4 corners: nw, ne, sw, se
+ * - 4 edges: n, s, e, w
+ *
+ * Handles all mouse events and dimension calculations internally.
+ */
+export declare const ResizeHandles: React.FC<ResizeHandlesProps>;
+export {};
+//# sourceMappingURL=ResizeHandles.d.ts.map

package/dist/frame/wrapper-app/components/ResizeHandles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResizeHandles.d.ts","sourceRoot":"","sources":["../../../../src/frame/wrapper-app/components/ResizeHandles.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAKxE,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAiLtD,CAAC"}

package/dist/frame/wrapper-app/components/SandboxContainer.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { SandboxContainerProps } from '../types';
+/**
+ * SandboxContainer - Container for the user's canvas/sketch with drag-resizing
+ *
+ * Features:
+ * - Renders user code (p5.js, Three.js, etc.) at canvas size
+ * - Canvas dimensions are PRECISELY set via CanvasContext (DPI-aware)
+ * - Display container size is derived from canvas size ÷ DPR
+ * - If canvas is larger than viewport we scale the container via CSS transforms
+ * - Presets set aspect ratio and maximize to fill container
+ * - Drag handles on all edges and corners for resizing
+ * - Dispatches window resize events when dimensions change
+ */
+export declare const SandboxContainer: React.FC<SandboxContainerProps>;
+//# sourceMappingURL=SandboxContainer.d.ts.map

package/dist/frame/wrapper-app/components/SandboxContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxContainer.d.ts","sourceRoot":"","sources":["../../../../src/frame/wrapper-app/components/SandboxContainer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAG3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA4G5D,CAAC"}

package/dist/frame/wrapper-app/components/index.d.ts

@@ -0,0 +1,5 @@
+export { CanvasSizeWidget } from './CanvasSizeWidget';
+export { ControlsPanel } from './ControlsPanel';
+export { ExportWidget } from './ExportWidget';
+export { SandboxContainer } from './SandboxContainer';
+//# sourceMappingURL=index.d.ts.map

package/dist/frame/wrapper-app/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/frame/wrapper-app/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/frame/wrapper-app/context/CanvasContext.d.ts

@@ -0,0 +1,37 @@
+import React, { ReactNode } from 'react';
+interface CanvasContextValue {
+    canvasWidth: number;
+    canvasHeight: number;
+    maxCanvasWidth: number;
+    maxCanvasHeight: number;
+    scale: number;
+    isFittedToScreen: boolean;
+    isRecording: boolean;
+    setIsRecording: (recording: boolean) => void;
+    setCanvasWidth: (width: number) => void;
+    setCanvasHeight: (height: number) => void;
+    setCanvasSize: (width: number, height: number) => void;
+    setAspectRatio: (aspectWidth: number, aspectHeight: number) => void;
+    syncWithCanvas: (canvasElement: HTMLCanvasElement) => void;
+    fitToScreen: () => void;
+}
+interface CanvasProviderProps {
+    children: ReactNode;
+}
+/**
+ * CanvasProvider - Manages canvas/container sizing state with scaling support
+ *
+ * Features:
+ * - Canvas size: The actual render dimensions (can be larger than viewport)
+ * - Auto-scaling: Canvas is scaled down to fit viewport if too large
+ * - Display container matches the scaled canvas size
+ */
+export declare const CanvasProvider: React.FC<CanvasProviderProps>;
+/**
+ * useCanvas - Hook to access canvas context
+ *
+ * @throws Error if used outside CanvasProvider
+ */
+export declare const useCanvas: () => CanvasContextValue;
+export {};
+//# sourceMappingURL=CanvasContext.d.ts.map

package/dist/frame/wrapper-app/context/CanvasContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasContext.d.ts","sourceRoot":"","sources":["../../../../src/frame/wrapper-app/context/CanvasContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAA+D,SAAS,EAAW,MAAM,OAAO,CAAC;AAE/G,UAAU,kBAAkB;IAE1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IAGrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IAGxB,KAAK,EAAE,MAAM,CAAC;IAEd,gBAAgB,EAAE,OAAO,CAAC;IAG1B,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAG7C,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAGvD,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAGpE,cAAc,EAAE,CAAC,aAAa,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAE3D,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAID,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAaD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAwMxD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAAO,kBAM5B,CAAC"}

package/dist/frame/wrapper-app/context/index.d.ts

@@ -0,0 +1,2 @@
+export { CanvasProvider, useCanvas } from './CanvasContext';
+//# sourceMappingURL=index.d.ts.map

package/dist/frame/wrapper-app/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/frame/wrapper-app/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/frame/wrapper-app/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @hypertool/runtime/frame/wrapper-app
+ *
+ * React-based wrapper application for the HyperFrame sandbox
+ */
+export { WrapperApp } from './WrapperApp';
+export type { WrapperAppProps, ControlsPanelProps, SandboxContainerProps } from './types';
+export { CanvasProvider, useCanvas } from './context';
+//# sourceMappingURL=index.d.ts.map

package/dist/frame/wrapper-app/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/frame/wrapper-app/index.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/frame/wrapper-app/types.d.ts

@@ -0,0 +1,38 @@
+import type { ControlDefinitions, ControlPanelOptions, ControlChangePayload } from '../types';
+export interface WrapperAppProps {
+    /**
+     * Callback when the sandbox container is ready
+     */
+    onContainerReady: (container: HTMLElement) => void;
+    /**
+     * Controls configuration
+     */
+    controls?: {
+        definitions: ControlDefinitions;
+        options?: ControlPanelOptions;
+        onChange?: (change: ControlChangePayload) => void;
+        onReady?: (controls: any) => void;
+    } | null;
+    /**
+     * Export widget configuration
+     */
+    exportWidget?: {
+        enabled: boolean;
+        filename?: string;
+        position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+        useCanvasCapture?: boolean;
+    } | null;
+}
+export interface ControlsPanelProps {
+    definitions: ControlDefinitions;
+    options?: ControlPanelOptions;
+    onChange?: (change: ControlChangePayload) => void;
+    onReady?: (controls: any) => void;
+}
+export interface SandboxContainerProps {
+    /**
+     * Callback when the container is mounted and ready
+     */
+    onReady: (container: HTMLElement) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/frame/wrapper-app/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/frame/wrapper-app/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EAGrB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,gBAAgB,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,IAAI,CAAC;IAEnD;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,WAAW,EAAE,kBAAkB,CAAC;QAChC,OAAO,CAAC,EAAE,mBAAmB,CAAC;QAC9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;QAClD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;KACnC,GAAG,IAAI,CAAC;IAET;;OAEG;IACH,YAAY,CAAC,EAAE;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;QACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,kBAAkB,CAAC;IAChC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C"}

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @hypertool/sdk
+ *
+ * HyperTool SDK - Vanilla-first SDK for embedding interactive experiences
+ *
+ * Main entry exports the Experience class (external API)
+ * Internal frame/controls are available via subpath imports:
+ * - @hypertool/sdk/frame
+ * - @hypertool/sdk/controls
+ * - @hypertool/sdk/recording
+ * - @hypertool/sdk/react
+ * - @hypertool/sdk/codegen
+ */
+export { Experience } from "./core/Experience";
+export type { ExperienceConfig, ExperienceContext, ExportsApi, EnvironmentApi, } from "./core/Experience";
+export { ParamStore } from "./core/ParamStore";
+export type { ParamType, ParamDefinition, ParamDefinitions, ParamValues, ParamChangeCallback, SelectOption, } from "./core/ParamStore";
+export { EventEmitter } from "./core/EventEmitter";
+export type { ExperienceEventType, ExperienceEvent, ReadyEvent, ErrorEvent, FrameEvent, ResizeEvent, ParamChangeEvent, PlayEvent, PauseEvent, EventHandler, } from "./core/EventEmitter";
+export { ObjectRegistry } from "./core/ObjectRegistry";
+export type { RegisteredObject, } from "./core/ObjectRegistry";
+import { HypertoolControls, createControlPanel, createControls, injectThemeVariables, studioTheme } from "./controls/index";
+import { runtime, mirrorCss, createSandbox, configureRuntime } from "./frame/index";
+export { HypertoolControls, createControlPanel, createControls, injectThemeVariables, studioTheme, };
+export type { ControlType, BaseControlDefinition, ControlDefinition, ControlDefinitions, NumberControlDefinition, ColorControlDefinition, BooleanControlDefinition, StringControlDefinition, SelectControlDefinition, HypertoolControlsOptions, ControlPosition, ParameterValues, ControlChangeContext, } from "./controls/types";
+export { runtime, mirrorCss, createSandbox, configureRuntime, };
+export type { HyperFrameRuntimeConfig, HyperFrameRuntimeApi, HyperFrameSandboxOptions, HyperFrameSandboxHandle, SandboxContext, SandboxEnvironment, SandboxControlsHandle, SandboxExportsApi, SandboxCaptureFn, SandboxCaptureResult, SandboxImageCaptureHandler, SandboxVideoCaptureHandler, SandboxControlChangeHandler, ControlChangePayload, ControlPanelOptions, MountOptions, MountResult, } from "./frame/types";
+export declare function registerSandboxParams(params: Record<string, unknown>): void;
+export declare function registerControlsInstance(controls: HypertoolControls | null): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EACV,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EACV,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,OAAO,EACP,SAAS,EACT,aAAa,EACb,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,WAAW,GACZ,CAAC;AAEF,YAAY,EAEV,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EAGvB,wBAAwB,EACxB,eAAe,EAGf,eAAe,EACf,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,OAAO,EACP,SAAS,EACT,aAAa,EACb,gBAAgB,GACjB,CAAC;AAEF,YAAY,EAEV,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EAGvB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAG3B,oBAAoB,EACpB,mBAAmB,EAGnB,YAAY,EACZ,WAAW,GACZ,MAAM,eAAe,CAAC;AAmCvB,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAEpE;AAGD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,QAE1E"}