paraframe 0.0.0-stage → 0.2.0

package/dist/internal/storage.js

@@ -0,0 +1,22 @@
+// Per-viewer conveniences only. Storage can be unavailable (private windows, blocked
+// site data), so every access is guarded and failures fall back to the default.
+export function readStored(store, key, fallback) {
+    try {
+        const raw = (store === 'local' ? localStorage : sessionStorage).getItem(key);
+        return raw === null ? fallback : JSON.parse(raw);
+    }
+    catch {
+        return fallback;
+    }
+}
+export function writeStored(store, key, value) {
+    try {
+        (store === 'local' ? localStorage : sessionStorage).setItem(key, JSON.stringify(value));
+    }
+    catch {
+        // Not persisting is fine.
+    }
+}
+export function storageKey(prototypeTitle, name) {
+    return `paraframe:${prototypeTitle}:${name}`;
+}

package/dist/messages.d.ts

@@ -0,0 +1,26 @@
+export type FrameMessage = 
+/** The frame has rendered and its fonts are loaded. */
+{
+    type: 'paraframe:ready';
+    frame: string;
+}
+/** A link in the frame was followed. */
+ | {
+    type: 'paraframe:navigate';
+    to: string;
+}
+/** A navigation key was pressed while the frame had focus. */
+ | {
+    type: 'paraframe:key';
+    key: string;
+};
+export declare function isFrameMessage(data: unknown): data is FrameMessage;
+export declare function postToHost(message: FrameMessage): void;
+/**
+ * Keys the player handles. Frames forward them so shortcuts work while a
+ * frame has focus. Comments listen in the frame themselves for C and Escape.
+ */
+export declare const PLAYER_KEYS: Set<string>;
+export declare function isEditable(target: EventTarget | null): boolean;
+/** Whether Enter on this target belongs to a focused control rather than to a global shortcut. */
+export declare function activatesOnEnter(target: EventTarget | null): boolean;

package/dist/messages.js

@@ -0,0 +1,27 @@
+// The protocol between a frame (inside an iframe) and the player around it.
+const TYPES = new Set(['paraframe:ready', 'paraframe:navigate', 'paraframe:key']);
+export function isFrameMessage(data) {
+    return (typeof data === 'object' &&
+        data !== null &&
+        TYPES.has(data.type));
+}
+export function postToHost(message) {
+    if (window.parent !== window)
+        window.parent.postMessage(message, location.origin);
+}
+/**
+ * Keys the player handles. Frames forward them so shortcuts work while a
+ * frame has focus. Comments listen in the frame themselves for C and Escape.
+ */
+export const PLAYER_KEYS = new Set(['ArrowLeft', 'ArrowRight', 'r', 'R']);
+export function isEditable(target) {
+    return (target instanceof HTMLElement &&
+        (target.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(target.tagName)));
+}
+// Controls that act on Enter themselves.
+const ACTIVATES_ON_ENTER = 'a[href],button,summary,[role=button],[role=link],[role=tab],[role=checkbox],[role=switch],' +
+    '[role=radio],[role=option],[role=menuitem],[role=menuitemradio],[role=menuitemcheckbox]';
+/** Whether Enter on this target belongs to a focused control rather than to a global shortcut. */
+export function activatesOnEnter(target) {
+    return target instanceof Element && target.closest(ACTIVATES_ON_ENTER) !== null;
+}

package/dist/nav.d.ts

@@ -0,0 +1,18 @@
+import type { Attachment } from 'svelte/attachments';
+/** Navigation between frames, available to any component inside a frame. */
+export interface FrameNav {
+    /** Id of the frame being shown. */
+    readonly current: string;
+    /** URL that opens a frame in the player. */
+    href(frameId: string): string;
+    /** Shows another frame. */
+    go(frameId: string): void;
+    /**
+     * Turns any element into a link to another frame, e.g. a table row:
+     * `<tr {@attach nav.hotspot('detail')}>`.
+     */
+    hotspot(frameId: string): Attachment<HTMLElement>;
+}
+export declare function setFrameNav(nav: FrameNav): void;
+/** Returns frame navigation. Outside a frame host, links do nothing. */
+export declare function useFrameNav(): FrameNav;

package/dist/nav.js

@@ -0,0 +1,15 @@
+import { getContext, setContext } from 'svelte';
+const KEY = Symbol('paraframe.nav');
+const detached = {
+    current: '',
+    href: () => '#',
+    go: () => { },
+    hotspot: () => () => { }
+};
+export function setFrameNav(nav) {
+    setContext(KEY, nav);
+}
+/** Returns frame navigation. Outside a frame host, links do nothing. */
+export function useFrameNav() {
+    return getContext(KEY) ?? detached;
+}

package/dist/prototype.d.ts

@@ -0,0 +1,10 @@
+import type { FrameSize, Prototype, PrototypeDefinition, ResolvedFrame } from './types.js';
+export declare const DEFAULT_SIZE: FrameSize;
+/** Validates a prototype definition and indexes its frames. Throws on bad or duplicate ids. */
+export declare function definePrototype(definition: PrototypeDefinition): Prototype;
+/** Prerender entries for a `[frame]` route parameter. */
+export declare function frameEntries(prototype: Prototype): {
+    frame: string;
+}[];
+/** Imports a frame's component. Use it in the frame route's `load`. Responds 404 for unknown ids. */
+export declare function resolveFrame(prototype: Prototype, frameId: string): Promise<ResolvedFrame>;

package/dist/prototype.js

@@ -0,0 +1,78 @@
+import { error } from '@sveltejs/kit';
+export const DEFAULT_SIZE = { width: 1440, height: 900 };
+const ID = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function assertId(kind, id) {
+    if (!ID.test(id)) {
+        throw new Error(`[paraframe] ${kind} id "${id}" must be lowercase letters, digits and dashes`);
+    }
+}
+/** Validates a prototype definition and indexes its frames. Throws on bad or duplicate ids. */
+export function definePrototype(definition) {
+    const size = { ...DEFAULT_SIZE, ...definition.size };
+    const frames = [];
+    const byId = new Map();
+    const sectionIds = new Set();
+    const sections = definition.sections.map((def) => {
+        assertId('Section', def.id);
+        if (sectionIds.has(def.id))
+            throw new Error(`[paraframe] Duplicate section id "${def.id}"`);
+        sectionIds.add(def.id);
+        const section = { id: def.id, title: def.title, columns: def.columns, frames: [] };
+        for (const f of def.frames) {
+            assertId('Frame', f.id);
+            if (byId.has(f.id))
+                throw new Error(`[paraframe] Duplicate frame id "${f.id}"`);
+            const frame = {
+                id: f.id,
+                title: f.title,
+                path: f.path,
+                load: f.load,
+                props: f.props ?? {},
+                size: { ...size, ...f.size },
+                section,
+                index: frames.length
+            };
+            frames.push(frame);
+            byId.set(f.id, frame);
+            section.frames.push(frame);
+        }
+        return section;
+    });
+    const flows = (definition.flows ?? []).map((flow) => {
+        assertId('Flow', flow.id);
+        if (!byId.has(flow.start)) {
+            throw new Error(`[paraframe] Flow "${flow.id}" starts on unknown frame "${flow.start}"`);
+        }
+        return { ...flow };
+    });
+    return {
+        title: definition.title,
+        description: definition.description,
+        size,
+        sections,
+        frames,
+        flows,
+        paths: definition.paths,
+        get: (id) => byId.get(id),
+        next: (id) => {
+            const frame = byId.get(id);
+            return frame ? frames[frame.index + 1] : undefined;
+        },
+        prev: (id) => {
+            const frame = byId.get(id);
+            return frame && frame.index > 0 ? frames[frame.index - 1] : undefined;
+        }
+    };
+}
+/** Prerender entries for a `[frame]` route parameter. */
+export function frameEntries(prototype) {
+    return prototype.frames.map((f) => ({ frame: f.id }));
+}
+/** Imports a frame's component. Use it in the frame route's `load`. Responds 404 for unknown ids. */
+export async function resolveFrame(prototype, frameId) {
+    const frame = prototype.get(frameId);
+    if (!frame)
+        error(404, `No frame "${frameId}" in this prototype`);
+    const module = await frame.load();
+    return { frame, component: module.default };
+}

package/dist/styles.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-ordinal:initial;--tw-slashed-zero:initial;--tw-numeric-figure:initial;--tw-numeric-spacing:initial;--tw-numeric-fraction:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-outline-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial}}}@layer theme{:root,:host{--font-sans:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--color-white:#fff;--spacing:.25rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--font-weight-medium:500;--font-weight-semibold:600;--leading-relaxed:1.625;--radius-md:.375rem;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring:where(:not(iframe)){outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components{.pf-toolbar{pointer-events:none;flex-wrap:wrap;justify-content:space-between;align-items:flex-start;gap:.5rem;display:flex}.pf-island{background:var(--pf-island);-webkit-backdrop-filter:blur(5px);backdrop-filter:blur(5px);min-width:0;max-width:100%;color:var(--pf-island-ink);pointer-events:auto;border-radius:9999px;align-items:center;gap:.125rem;padding:.25rem;display:flex}.pf-tool{min-width:2rem;height:2rem;color:var(--pf-island-ink);border-radius:9999px;outline:none;justify-content:center;align-items:center;display:inline-flex}.pf-tool:hover,.pf-tool[aria-expanded=true]{background:var(--pf-island-hover)}.pf-tool:disabled{opacity:.35;pointer-events:none}.pf-tool[aria-pressed=true],.pf-tool-primary{background:var(--pf-island-ink);color:var(--pf-ink)}.pf-tool-primary{gap:.375rem;padding-inline:.875rem 1rem;font-weight:500}.pf-tool-primary:hover{background:#ffffffd9}.pf-tool:focus-visible{box-shadow:0 0 0 2px var(--pf-island-muted)}.pf-tool-light{border-radius:.125rem;outline:none;justify-content:center;align-items:center;min-width:1.75rem;height:1.75rem;display:inline-flex}.pf-tool-light:hover{background:var(--pf-wash)}.pf-tool-light:focus-visible{box-shadow:0 0 0 2px var(--pf-accent)}}@layer utilities{.pointer-events-none{pointer-events:none}.visible{visibility:visible}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.inset-0{inset:0}.inset-auto{inset:auto}.inset-x-3{inset-inline:calc(var(--spacing) * 3)}.top-0{top:0}.top-1{top:var(--spacing)}.top-3{top:calc(var(--spacing) * 3)}.top-\[60px\]{top:60px}.right-1{right:var(--spacing)}.right-3{right:calc(var(--spacing) * 3)}.bottom-3{bottom:calc(var(--spacing) * 3)}.left-0{left:0}.z-10{z-index:10}.z-20{z-index:20}.m-0{margin:0}.m-3{margin:calc(var(--spacing) * 3)}.m-auto{margin:auto}.my-3{margin-block:calc(var(--spacing) * 3)}.mr-3{margin-right:calc(var(--spacing) * 3)}.mb-0{margin-bottom:0}.ml-auto{margin-left:auto}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline-flex{display:inline-flex}.table{display:table}.size-2{width:calc(var(--spacing) * 2);height:calc(var(--spacing) * 2)}.size-full{width:100%;height:100%}.h-5{height:calc(var(--spacing) * 5)}.h-dvh{height:100dvh}.max-h-\[min\(70vh\,560px\)\]{max-height:min(70vh,560px)}.min-h-0{min-height:0}.min-h-10{min-height:calc(var(--spacing) * 10)}.w-4{width:calc(var(--spacing) * 4)}.w-20{width:calc(var(--spacing) * 20)}.w-80{width:calc(var(--spacing) * 80)}.w-full{width:100%}.w-max{width:max-content}.max-w-48{max-width:calc(var(--spacing) * 48)}.max-w-60{max-width:calc(var(--spacing) * 60)}.max-w-\[calc\(100vw-24px\)\]{max-width:calc(100vw - 24px)}.max-w-full{max-width:100%}.min-w-0{min-width:0}.min-w-16{min-width:calc(var(--spacing) * 16)}.min-w-52{min-width:calc(var(--spacing) * 52)}.flex-1{flex:1}.shrink-0{flex-shrink:0}.origin-top-left{transform-origin:0 0}.cursor-grabbing{cursor:grabbing}.touch-none{touch-action:none}.resize{resize:both}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-baseline{align-items:baseline}.items-center{align-items:center}.items-start{align-items:flex-start}.justify-between{justify-content:space-between}.justify-end{justify-content:flex-end}.gap-1{gap:var(--spacing)}.gap-1\.5{gap:calc(var(--spacing) * 1.5)}.gap-2{gap:calc(var(--spacing) * 2)}.gap-2\.5{gap:calc(var(--spacing) * 2.5)}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.rounded{border-radius:.25rem}.rounded-\[2px\]{border-radius:2px}.rounded-\[16px\]{border-radius:16px}.rounded-full{border-radius:3.40282e38px}.rounded-md{border-radius:var(--radius-md)}.border{border-style:var(--tw-border-style);border-width:1px}.border-0{border-style:var(--tw-border-style);border-width:0}.border-t{border-top-style:var(--tw-border-style);border-top-width:1px}.border-pf-line{border-color:var(--pf-line)}.border-white\/10{border-color:#ffffff1a}@supports (color:color-mix(in lab, red, red)){.border-white\/10{border-color:color-mix(in oklab, var(--color-white) 10%, transparent)}}.bg-pf-accent{background-color:var(--pf-accent)}.bg-pf-canvas{background-color:var(--pf-canvas)}.bg-pf-comment{background-color:var(--pf-comment)}.bg-pf-ink{background-color:var(--pf-ink)}.bg-pf-section{background-color:var(--pf-section)}.bg-pf-stage{background-color:var(--pf-stage)}.bg-pf-surface{background-color:var(--pf-surface)}.bg-white{background-color:var(--color-white)}.p-0\.5{padding:calc(var(--spacing) * .5)}.p-1{padding:var(--spacing)}.px-1{padding-inline:var(--spacing)}.px-2{padding-inline:calc(var(--spacing) * 2)}.px-3{padding-inline:calc(var(--spacing) * 3)}.py-1\.5{padding-block:calc(var(--spacing) * 1.5)}.pt-2{padding-top:calc(var(--spacing) * 2)}.pr-2{padding-right:calc(var(--spacing) * 2)}.pr-4{padding-right:calc(var(--spacing) * 4)}.pr-5{padding-right:calc(var(--spacing) * 5)}.pb-1{padding-bottom:var(--spacing)}.pl-1{padding-left:var(--spacing)}.pl-1\.5{padding-left:calc(var(--spacing) * 1.5)}.pl-3\.5{padding-left:calc(var(--spacing) * 3.5)}.text-center{text-align:center}.text-left{text-align:left}.font-pf{font-family:var(--pf-font)}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.text-\[11px\]{font-size:11px}.text-\[13px\]{font-size:13px}.leading-5{--tw-leading:calc(var(--spacing) * 5);line-height:calc(var(--spacing) * 5)}.leading-relaxed{--tw-leading:var(--leading-relaxed);line-height:var(--leading-relaxed)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.text-pf-accent{color:var(--pf-accent)}.text-pf-canvas-ink{color:var(--pf-canvas-ink)}.text-pf-canvas-muted{color:var(--pf-canvas-muted)}.text-pf-ink{color:var(--pf-ink)}.text-pf-island-muted{color:var(--pf-island-muted)}.text-pf-muted{color:var(--pf-muted)}.text-pf-selection{color:var(--pf-selection)}.text-pf-surface{color:var(--pf-surface)}.text-white\/90{color:#ffffffe6}@supports (color:color-mix(in lab, red, red)){.text-white\/90{color:color-mix(in oklab, var(--color-white) 90%, transparent)}}.lowercase{text-transform:lowercase}.tabular-nums{--tw-numeric-spacing:tabular-nums;font-variant-numeric:var(--tw-ordinal,) var(--tw-slashed-zero,) var(--tw-numeric-figure,) var(--tw-numeric-spacing,) var(--tw-numeric-fraction,)}.underline{text-decoration-line:underline}.opacity-50{opacity:.5}.shadow-lg{--tw-shadow:0 10px 15px -3px var(--tw-shadow-color,#0000001a), 0 4px 6px -4px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.shadow-sm{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a), 0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.ring-1{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.ring-2{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.ring-pf-selection,.ring-pf-selection\/60{--tw-ring-color:var(--pf-selection)}@supports (color:color-mix(in lab, red, red)){.ring-pf-selection\/60{--tw-ring-color:color-mix(in oklab, var(--pf-selection) 60%, transparent)}}.outline{outline-style:var(--tw-outline-style);outline-width:1px}.filter{filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-opacity{transition-property:opacity;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.outline-none{--tw-outline-style:none;outline-style:none}.select-none{-webkit-user-select:none;user-select:none}@media (hover:hover){.hover\:bg-pf-selection\/10:hover{background-color:var(--pf-selection)}@supports (color:color-mix(in lab, red, red)){.hover\:bg-pf-selection\/10:hover{background-color:color-mix(in oklab, var(--pf-selection) 10%, transparent)}}.hover\:bg-pf-wash:hover{background-color:var(--pf-wash)}.hover\:bg-white\/10:hover{background-color:#ffffff1a}@supports (color:color-mix(in lab, red, red)){.hover\:bg-white\/10:hover{background-color:color-mix(in oklab, var(--color-white) 10%, transparent)}}.hover\:text-pf-canvas-ink:hover{color:var(--pf-canvas-ink)}.hover\:brightness-110:hover{--tw-brightness:brightness(110%);filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}}.focus-visible\:bg-pf-wash:focus-visible{background-color:var(--pf-wash)}.focus-visible\:bg-white\/10:focus-visible{background-color:#ffffff1a}@supports (color:color-mix(in lab, red, red)){.focus-visible\:bg-white\/10:focus-visible{background-color:color-mix(in oklab, var(--color-white) 10%, transparent)}}.data-\[pf-hover\=true\]\:pointer-events-auto[data-pf-hover=true]{pointer-events:auto}@media (min-width:40rem){.sm\:inline{display:inline}}@media (min-width:48rem){.md\:inline{display:inline}}}:root{--pf-font:ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;--pf-ink:#292524;--pf-muted:#78716c;--pf-line:#d6d3d1;--pf-wash:#e7e5e4;--pf-surface:#f5f5f4;--pf-canvas:#1c1917;--pf-canvas-ink:#e7e5e4;--pf-canvas-muted:#a8a29e;--pf-selection:#f5f5f4;--pf-section:#292524;--pf-grid:#a8a29e33;--pf-stage:#1c1917;--pf-accent:#57534e;--pf-avatar:#009aaa;--pf-comment:#0d99ff;--pf-comment-soft:#e5f4ff;--vc-comment:var(--pf-comment);--vc-comment-soft:var(--pf-comment-soft);--vc-avatar:var(--pf-avatar);--vc-font:var(--pf-font);--pf-island:#32323291;--pf-island-ink:#fff;--pf-island-muted:#fff9;--pf-island-hover:#ffffff1f}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-ordinal{syntax:"*";inherits:false}@property --tw-slashed-zero{syntax:"*";inherits:false}@property --tw-numeric-figure{syntax:"*";inherits:false}@property --tw-numeric-spacing{syntax:"*";inherits:false}@property --tw-numeric-fraction{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-outline-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}

package/dist/types.d.ts

@@ -0,0 +1,100 @@
+import type { Component } from 'svelte';
+export type FrameComponent = Component<any>;
+/** A frame's viewport in CSS pixels. */
+export interface FrameSize {
+    width: number;
+    height: number;
+}
+export interface FrameDefinition {
+    /** URL-safe identifier: lowercase letters, digits and single dashes. */
+    id: string;
+    title: string;
+    /** Where the screen lives in the product, e.g. `/{account}/projects`. Shown beside the title. */
+    path?: string;
+    /** Imports the frame's component, e.g. `() => import('./Overview.svelte')`. */
+    load: () => Promise<{
+        default: FrameComponent;
+    }>;
+    /** Props passed to the component, so one component can back several frames. */
+    props?: Record<string, unknown>;
+    /** Overrides the prototype's default size. */
+    size?: Partial<FrameSize>;
+}
+export interface SectionDefinition {
+    id: string;
+    title: string;
+    frames: FrameDefinition[];
+    /** Wrap frames onto a new canvas row after this many. Default: one row. */
+    columns?: number;
+}
+/** A named starting point for clicking through the prototype. */
+export interface FlowDefinition {
+    id: string;
+    title: string;
+    /** Id of the frame the flow starts on. */
+    start: string;
+}
+/**
+ * Where the host app mounts paraframe's three views. Build these with
+ * `resolve()` from `$app/paths` so base paths are respected, e.g.
+ * `play: (frame) => resolve(`play/${frame}`)`.
+ */
+export interface PrototypePaths {
+    /** The canvas with every frame. */
+    canvas: () => string;
+    /** The player, showing one frame. */
+    play: (frameId: string) => string;
+    /** A frame rendered on its own, without paraframe's chrome. Loaded inside iframes. */
+    frame: (frameId: string) => string;
+}
+export interface PrototypeDefinition {
+    title: string;
+    description?: string;
+    /** Default frame size. Default: 1440 × 900. */
+    size?: Partial<FrameSize>;
+    sections: SectionDefinition[];
+    flows?: FlowDefinition[];
+    paths: PrototypePaths;
+}
+export interface Frame {
+    id: string;
+    title: string;
+    path: string | undefined;
+    load: FrameDefinition['load'];
+    props: Record<string, unknown>;
+    size: FrameSize;
+    section: Section;
+    /** Position in reading order across all sections. */
+    index: number;
+}
+export interface Section {
+    id: string;
+    title: string;
+    columns: number | undefined;
+    frames: Frame[];
+}
+export interface Flow {
+    id: string;
+    title: string;
+    start: string;
+}
+export interface Prototype {
+    title: string;
+    description: string | undefined;
+    size: FrameSize;
+    sections: Section[];
+    /** Every frame, in reading order. */
+    frames: Frame[];
+    flows: Flow[];
+    paths: PrototypePaths;
+    get(frameId: string): Frame | undefined;
+    /** The frame after this one in reading order, if any. */
+    next(frameId: string): Frame | undefined;
+    /** The frame before this one in reading order, if any. */
+    prev(frameId: string): Frame | undefined;
+}
+/** A frame with its component imported, ready to render. */
+export interface ResolvedFrame {
+    frame: Frame;
+    component: FrameComponent;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,98 @@
 {
-  "name": "paraframe",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "paraframe",
+	"version": "0.2.0",
+	"description": "Click through Svelte prototypes like a Figma file: real Svelte components as frames, on a zoomable canvas and in a flow player.",
+	"keywords": [
+		"svelte",
+		"sveltekit",
+		"svelte5",
+		"prototype",
+		"prototyping",
+		"prototype-viewer",
+		"canvas",
+		"infinite-canvas",
+		"design-tools",
+		"figma",
+		"frames"
+	],
+	"homepage": "https://paraframe.convex.works",
+	"bugs": "https://github.com/Convex-Works/paraframe/issues",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Convex-Works/paraframe.git"
+	},
+	"license": "MIT",
+	"author": "Convex Works",
+	"type": "module",
+	"packageManager": "pnpm@12.4.1",
+	"engines": {
+		"node": ">=22.17"
+	},
+	"scripts": {
+		"dev": "svelte-kit sync && svelte-package && pnpm css && (svelte-package --watch --preserve-output & pnpm css --watch)",
+		"package": "svelte-kit sync && svelte-package && pnpm css && publint",
+		"css": "tailwindcss -i src/styles.css -o dist/styles.css --minify",
+		"showcase": "vite dev",
+		"build": "vite build && pnpm package",
+		"preview": "vite preview",
+		"prepare": "svelte-kit sync || echo ''",
+		"prepack": "pnpm package",
+		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --tsgo",
+		"test": "vitest run"
+	},
+	"files": [
+		"dist",
+		"!dist/**/*.test.*",
+		"!dist/**/*.spec.*"
+	],
+	"sideEffects": [
+		"**/*.css"
+	],
+	"svelte": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"svelte": "./dist/index.js"
+		},
+		"./comments": {
+			"types": "./dist/comments.d.ts",
+			"svelte": "./dist/comments.js"
+		},
+		"./styles.css": "./dist/styles.css"
+	},
+	"peerDependencies": {
+		"@sveltejs/kit": "^3.0.0",
+		"svelte": "^5.57.1",
+		"visual-comments": "^0.1.0"
+	},
+	"peerDependenciesMeta": {
+		"visual-comments": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@convex-works/sign-in": "link:../sign-in",
+		"@sveltejs/adapter-static": "^4.0.0",
+		"@sveltejs/kit": "^3.0.0",
+		"@sveltejs/package": "^3.0.0",
+		"@sveltejs/vite-plugin-svelte": "^7.2.0",
+		"@tailwindcss/cli": "^4.3.3",
+		"@tailwindcss/vite": "^4.3.0",
+		"@types/node": "^26.6.5",
+		"@typescript/native": "npm:typescript@^7.0.2",
+		"happy-dom": "^21.0.3",
+		"publint": "^0.3.21",
+		"svelte": "^5.57.1",
+		"svelte-check": "^4.7.6",
+		"tailwindcss": "^4.3.0",
+		"typescript": "~6.0.3",
+		"visual-comments": "^0.1.0",
+		"vite": "^8.3.0",
+		"vitest": "^5.0.5"
+	},
+	"imports": {
+		"#lib": "./src/lib/index.js",
+		"#lib/*": "./src/lib/*"
+	}
+}