ryugi-artifacts 1.47.0 → 1.48.0

package/dist/viewer-lib/types/src/shared/ids.d.ts

@@ -1,5 +1,7 @@
 import { type ArtifactType } from './types';
 export declare const ARTIFACT_LOCATOR_SOURCE = "(?:[a-z0-9][a-z0-9-]*|(?:[\\w-]{21}|[a-f0-9]{32}))";
+export declare function mintArtifactId(): string;
+export declare const isMintedArtifactId: (id: string) => boolean;
 export declare const isArtifactId: (id: string) => boolean;
 export declare const isArtifactAddress: (id: string) => boolean;
 export declare const isArtifactLocator: (id: string) => boolean;

package/dist/viewer-lib/types/src/shared/relay.d.ts

@@ -35,7 +35,8 @@ export type RelayReply<T = unknown> = {
 export type LiveHost = {
     hostId: string;
     port: number;
-    key: string;
+    key?: string;
+    embed?: boolean;
 };
 export type RelayPresence = {
     online: boolean;

package/dist/viewer-lib/types/src/viewer/components/Canvas.d.ts

@@ -1,25 +1,33 @@
+import { type Ref } from 'react';
 import { type BoardSpec, type NoteSpec } from '../../shared/types';
 import type { Inspector } from '../hooks/useInspector';
-import type { BoardRender } from '../lib/board-tiers';
+import type { BoardPhase } from '../lib/board-lifecycle';
 import { type View } from '../lib/view';
-interface CanvasProps {
-    agent?: string;
+interface BoardsProps {
+    boardBase?: string;
     boards: [string, BoardSpec][];
+    boardSandbox?: string;
     contentBase: string;
+    culled?: ReadonlySet<string>;
     frameLoaded: Inspector['loaded'];
     frameRef: Inspector['refFor'];
+    gesturing?: boolean;
+    images?: ReadonlyMap<string, string>;
     inspecting: boolean;
-    live?: boolean;
-    notes: [string, NoteSpec][];
     onExpand?: (id: string) => void;
-    onImageError?: (id: string, src: string) => void;
     pending: ReadonlySet<string>;
+    phases?: ReadonlyMap<string, BoardPhase>;
     playing: ReadonlySet<string>;
-    renders: ReadonlyMap<string, BoardRender>;
     replays: Record<string, number>;
     versions: Record<string, number>;
-    view: View;
     writing?: string;
 }
-export declare function Canvas({ view, renders, boards, notes, contentBase, versions, pending, playing, replays, inspecting, frameRef, frameLoaded, live, writing, agent, onExpand, onImageError, }: CanvasProps): import("react").JSX.Element;
+interface CanvasProps extends BoardsProps {
+    agent?: string;
+    live?: boolean;
+    notes: [string, NoteSpec][];
+    view: View;
+    worldRef?: Ref<HTMLDivElement>;
+}
+export declare function Canvas({ boardBase, boardSandbox, view, worldRef, phases, images, culled, gesturing, boards, notes, contentBase, versions, pending, playing, replays, inspecting, frameRef, frameLoaded, live, writing, agent, onExpand, }: CanvasProps): import("react").JSX.Element;
 export {};

package/dist/viewer-lib/types/src/viewer/components/DebugHud.d.ts

@@ -1,5 +1,13 @@
-import type { BoardRender } from '../lib/board-tiers';
-export declare function DebugHud({ renders, scaling, }: {
-    renders: ReadonlyMap<string, BoardRender>;
-    scaling: boolean;
+interface BoardCounts {
+    capturing: number;
+    mounted: number;
+    restoring: number;
+    uncapturable: number;
+    unloaded: number;
+}
+export declare function DebugHud({ counts, culled, gesturing, }: {
+    counts: BoardCounts;
+    culled: number;
+    gesturing: boolean;
 }): import("react").JSX.Element;
+export {};

package/dist/viewer-lib/types/src/viewer/components/EmbeddedCanvas.d.ts

@@ -0,0 +1,6 @@
+export declare function EmbeddedCanvas({ src, title, onReady, onLost, }: {
+    src: string;
+    title: string;
+    onReady?: () => void;
+    onLost: () => void;
+}): import("react").JSX.Element;

package/dist/viewer-lib/types/src/viewer/components/ExpandedBoard.d.ts

@@ -9,7 +9,8 @@ interface ExpandedBoardProps {
     onFrameLoad?: () => void;
     parameterAction?: ReactNode;
     parameters?: ReactNode;
+    sandbox?: string;
     src: string;
 }
-export declare function ExpandedBoard({ id, board, src, interactive, onClose, parameterAction, parameters, frameRef, onFrameLoad, }: ExpandedBoardProps): import("react").JSX.Element;
+export declare function ExpandedBoard({ id, board, sandbox, src, interactive, onClose, parameterAction, parameters, frameRef, onFrameLoad, }: ExpandedBoardProps): import("react").JSX.Element;
 export {};

package/dist/viewer-lib/types/src/viewer/components/PhoneBoard.d.ts

@@ -11,8 +11,9 @@ interface Props {
     onClose: () => void;
     onOpen: (id: string) => void;
     origin?: Rect;
+    sandbox?: string;
     siblings: string[];
     src: string;
 }
-export declare function PhoneBoard({ id, board, src, siblings, origin, onOpen, onClose }: Props): import("react").JSX.Element;
+export declare function PhoneBoard({ id, board, sandbox, src, siblings, origin, onOpen, onClose, }: Props): import("react").JSX.Element;
 export {};

package/dist/viewer-lib/types/src/viewer/hooks/useBoardLifecycle.d.ts

@@ -0,0 +1,28 @@
+import { type BoardSpec } from '../../shared/types';
+import { type BoardPhase } from '../lib/board-lifecycle';
+import type { View } from '../lib/view';
+interface Options {
+    active: ReadonlySet<string>;
+    boards: [string, BoardSpec][];
+    gesturing: boolean;
+    pending: ReadonlySet<string>;
+    versions: Record<string, number>;
+    view: View;
+    viewport: {
+        width: number;
+        height: number;
+    };
+}
+export declare function useBoardLifecycle({ boards, versions, pending, view, viewport, active, gesturing, }: Options): {
+    phases: Map<string, BoardPhase>;
+    images: ReadonlyMap<string, string>;
+    frameRef: (id: string) => (element: HTMLIFrameElement | null) => void;
+    counts: {
+        uncapturable: number;
+        capturing: number;
+        mounted: number;
+        restoring: number;
+        unloaded: number;
+    };
+};
+export {};

package/dist/viewer-lib/types/src/viewer/hooks/useBoardOrigin.d.ts

@@ -0,0 +1,8 @@
+import { type BoardOrigin } from '../lib/board-origin';
+interface Options {
+    boardPath?: string;
+    boardPort?: number;
+    contentBase: string;
+}
+export declare function useBoardOrigin({ contentBase, boardPort, boardPath }: Options): BoardOrigin | null;
+export {};

package/dist/viewer-lib/types/src/viewer/hooks/useCanvasData.d.ts

@@ -8,6 +8,8 @@ export declare function useCanvasData({ live, revision, load, send, boardComment
     recordings?: Record<string, import("../library").RecordingState>;
     versions: Record<string, number>;
     warnings: string[];
+    boardPath?: string;
+    boardPort?: number;
     contentBase: string;
     stale: boolean;
     loaded: boolean;

package/dist/viewer-lib/types/src/viewer/hooks/useCulledBoards.d.ts

@@ -0,0 +1,6 @@
+import type { BoardSpec } from '../../shared/types';
+import type { View } from '../lib/view';
+export declare function useCulledBoards(boards: [string, BoardSpec][], view: View, viewport: {
+    width: number;
+    height: number;
+}): ReadonlySet<string>;

package/dist/viewer-lib/types/src/viewer/hooks/usePanZoom.d.ts

@@ -2,6 +2,7 @@ import { type PointerEvent as ReactPointerEvent } from 'react';
 import type { Bounds } from '../../shared/types';
 import { type Insets, type View } from '../lib/view';
 export type Tool = 'select' | 'hand' | 'comment';
+export declare const GESTURE_SETTLE_MS = 150;
 export interface WheelInput {
     deltaX: number;
     deltaY: number;
@@ -11,13 +12,15 @@ export interface WheelInput {
 }
 export declare function usePanZoom(tool: Tool): {
     viewportRef: import("react").RefObject<HTMLDivElement | null>;
+    worldRef: (el: HTMLDivElement | null) => void;
     view: View;
+    gesturing: boolean;
     scaling: boolean;
     size: {
         width: number;
         height: number;
     };
-    place: import("react").Dispatch<import("react").SetStateAction<View>>;
+    place: (next: View) => void;
     fit: (bounds: Bounds | null | undefined, insets?: Insets, options?: {
         animate?: boolean;
     }) => void;

package/dist/viewer-lib/types/src/viewer/layouts/ArtboardView.d.ts

@@ -8,7 +8,6 @@ export type ArtboardViewProps = Omit<ReturnType<typeof useCanvasData>, 'live' |
     artifact: string | null;
     live?: boolean;
     actions?: ReactNode;
-    tiers?: boolean;
     send?: (message: SelectionMessage) => void;
     comments?: BoardCommentsState | null;
     comment?: (op: BoardHumanOp) => Promise<BoardCommentsState>;

package/dist/viewer-lib/types/src/viewer/layouts/PhoneArtboard.d.ts

@@ -1,10 +1,12 @@
 import { type ReactNode } from 'react';
-import type { CanvasLayout, CanvasSpec } from '../../shared/types';
+import { type CanvasLayout, type CanvasSpec } from '../../shared/types';
 import type { BoardCommentsState } from '../lib/board-comments';
 interface Props {
     actions?: ReactNode;
     agent?: string;
     artifact: string | null;
+    boardPath?: string;
+    boardPort?: number;
     canvas: CanvasSpec | null;
     comments?: BoardCommentsState | null;
     contentBase: string;
@@ -13,9 +15,8 @@ interface Props {
     live?: boolean;
     loaded: boolean;
     pending: string[];
-    tiers?: boolean;
     versions: Record<string, number>;
     warnings: string[];
 }
-export declare function PhoneArtboard({ id, artifact, canvas, layout, warnings, pending, contentBase, versions, live, loaded, agent, comments, actions, tiers: tiered, }: Props): import("react").JSX.Element;
+export declare function PhoneArtboard({ id, canvas, layout, warnings, pending, contentBase, boardPort, boardPath, versions, live, loaded, agent, comments, actions, }: Props): import("react").JSX.Element;
 export {};

package/dist/viewer-lib/types/src/viewer/lib/board-lifecycle.d.ts

@@ -0,0 +1,46 @@
+import type { View } from './view';
+export declare const IDLE_UNLOAD_MS = 300000;
+export declare const READY_TIMEOUT_MS = 8000;
+export declare const CAPTURE_TIMEOUT_MS = 10000;
+export type BoardPhase = 'mounted' | 'capturing' | 'unloaded' | 'restoring';
+export interface LifecycleBoard {
+    h: number;
+    id: string;
+    version: number;
+    w: number;
+    x: number;
+    y: number;
+}
+export interface LifecycleInput {
+    active: ReadonlySet<string>;
+    boards: LifecycleBoard[];
+    gesturing: boolean;
+    view: View;
+    viewport: {
+        width: number;
+        height: number;
+    };
+}
+export interface LifecycleOutput {
+    capture: string[];
+    phases: Map<string, BoardPhase>;
+    uncapturable: ReadonlySet<string>;
+    wakeAt: number | null;
+}
+interface Options {
+    captureTimeoutMs?: number;
+    idleMs?: number;
+    now?: () => number;
+    readyTimeoutMs?: number;
+}
+export declare function createBoardLifecycle({ now, idleMs, readyTimeoutMs, captureTimeoutMs, }?: Options): {
+    update({ boards, view, viewport, active, gesturing }: LifecycleInput): LifecycleOutput;
+    touch(id: string): void;
+    captured(id: string, { version, ok }: {
+        version: number;
+        ok: boolean;
+    }): void;
+    ready(id: string): void;
+};
+export type BoardLifecycle = ReturnType<typeof createBoardLifecycle>;
+export {};

package/dist/viewer-lib/types/src/viewer/lib/board-origin.d.ts

@@ -0,0 +1,21 @@
+export declare const BOARD_SANDBOX_SAME_SITE = "allow-scripts allow-same-origin allow-forms allow-popups allow-modals allow-downloads";
+export declare const BOARD_SANDBOX_OPAQUE = "allow-scripts";
+export interface BoardOrigin {
+    base: string;
+    mode: 'same-site' | 'opaque';
+    sandbox: string;
+}
+interface Input {
+    boardPath?: string;
+    boardPort?: number;
+    contentBase: string;
+    location: {
+        hostname: string;
+        origin: string;
+        protocol: string;
+    };
+    reachable?: boolean;
+}
+export declare function boardOrigin({ location, contentBase, boardPort, boardPath, reachable, }: Input): BoardOrigin;
+export declare const boardProbeUrl: (location: Input['location'], boardPort: number) => string;
+export {};

package/dist/viewer-lib/types/src/viewer/lib/cull.d.ts

@@ -0,0 +1,14 @@
+import type { View } from './view';
+export declare const CULL_MARGIN = 240;
+interface Box {
+    h: number;
+    id: string;
+    w: number;
+    x: number;
+    y: number;
+}
+export declare function culledBoards(boards: Box[], view: View, viewport: {
+    width: number;
+    height: number;
+}, margin?: number): Set<string>;
+export {};

package/dist/viewer-lib/types/src/viewer/lib/embed-bridge.d.ts

@@ -0,0 +1,27 @@
+export declare const EMBED_HEARTBEAT_MS = 1000;
+export declare const EMBED_LOST_MS = 5000;
+type MessageWindow = Pick<Window, 'addEventListener' | 'removeEventListener'>;
+export declare function createEmbedChild({ parentOrigin, win, }: {
+    parentOrigin: string;
+    win?: MessageWindow & {
+        parent: Pick<Window, 'postMessage'>;
+    };
+}): {
+    close: () => void;
+};
+export declare function startEmbedChild(doc?: Pick<Document, 'documentElement'>, win?: MessageWindow & {
+    parent: Pick<Window, 'postMessage'>;
+}): {
+    close: () => void;
+} | null;
+export declare function createEmbedHost({ frame, childOrigin, onReady, onLost, lostAfterMs, win, }: {
+    childOrigin: string;
+    frame: () => Window | null | undefined;
+    lostAfterMs?: number;
+    onLost: () => void;
+    onReady: () => void;
+    win?: MessageWindow;
+}): {
+    close(): void;
+};
+export {};

package/dist/viewer-lib/types/src/viewer/lib/payload.d.ts

@@ -1,5 +1,7 @@
 import type { CanvasPayload } from '../../shared/types';
 export interface ViewerPayload extends CanvasPayload {
+    boardPath?: string;
+    boardPort?: number;
     contentBase: string;
     stale: boolean;
 }

package/dist/viewer-lib/types/src/viewer/library/index.d.ts

@@ -10,6 +10,7 @@ export * from '../../shared/type-icons';
 export * from '../../shared/types';
 export { ArtifactThumbnail } from '../components/ArtifactThumbnail';
 export { CanvasErrorBoundary } from '../components/CanvasErrorBoundary';
+export { EmbeddedCanvas } from '../components/EmbeddedCanvas';
 export { PublicationStatus } from '../components/PublicationStatus';
 export { RailSwitch } from '../components/RailSwitch';
 export { RyugiMark } from '../components/RyugiMark';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ryugi-artifacts",
-  "version": "1.47.0",
+  "version": "1.48.0",
   "description": "Server and viewer for the Ryugi artifacts app",
   "repository": {
     "type": "git",
@@ -22,6 +22,10 @@
       "types": "./dist/viewer-lib/types/src/viewer/library/document.d.ts",
       "default": "./dist/viewer-lib/document.js"
     },
+    "./ids": {
+      "types": "./dist/viewer-lib/types/src/shared/ids.d.ts",
+      "default": "./dist/viewer-lib/ids.js"
+    },
     "./thumbnail": {
       "types": "./dist/viewer-lib/types/src/shared/thumbnail.d.ts",
       "default": "./dist/viewer-lib/thumbnail.js"
@@ -44,9 +48,10 @@
     "dist/viewer-lib"
   ],
   "scripts": {
+    "bench:zoom": "node bench/zoom/run.mjs",
     "build": "pnpm run build:server && pnpm run build:cli && pnpm run build:viewer && pnpm run build:lib && pnpm run build:runtime",
     "build:cli": "node scripts/build-cli.mjs",
-    "build:lib": "NODE_ENV=production vite build -c vite.lib.config.ts && esbuild src/shared/thumbnail.ts --bundle --platform=neutral --format=esm --outfile=dist/viewer-lib/thumbnail.js && tsrs -p tsconfig.lib.json",
+    "build:lib": "NODE_ENV=production vite build -c vite.lib.config.ts && esbuild src/shared/thumbnail.ts --bundle --platform=neutral --format=esm --outfile=dist/viewer-lib/thumbnail.js && esbuild src/shared/ids.ts --bundle --platform=neutral --format=esm --outfile=dist/viewer-lib/ids.js && tsrs -p tsconfig.lib.json",
     "build:runtime": "NODE_ENV=production vite build -c vite.runtime.config.ts && node scripts/inline-runtime-css.mjs && node scripts/build-icons.mjs",
     "build:server": "esbuild src/server/main.ts --bundle --platform=node --target=node18 --format=cjs --alias:loro-crdt=loro-crdt/base64 --outfile=dist/server.cjs && node -e \"const fs=require('node:fs');fs.copyFileSync('dist/server.cjs','../skills/artifacts/app/server.cjs')\"",
     "build:viewer": "NODE_ENV=production vite build && node -e \"const fs=require('node:fs');const to='../skills/artifacts/app/viewer';fs.rmSync(to,{recursive:true,force:true});fs.cpSync('dist/viewer',to,{recursive:true})\"",