@jtfmumm/patchwork-standalone-frame 0.1.0 → 0.3.0

package/dist/frame.d.ts

@@ -1,5 +1,5 @@
-import { type AutomergeRepoKeyhive } from "@automerge/automerge-repo-keyhive";
-import type { ToolRegistration } from "./index.ts";
+import type { AutomergeRepoKeyhive } from "@automerge/automerge-repo-keyhive";
+import type { ToolRegistration, StandaloneFrameConfig } from "./index.ts";
 declare global {
     interface Window {
         hive?: AutomergeRepoKeyhive;
@@ -7,4 +7,5 @@ declare global {
 }
 export declare function StandaloneApp<D>(props: {
     tool: ToolRegistration<D>;
+    config?: StandaloneFrameConfig;
 }): import("solid-js").JSX.Element;

package/dist/index.d.ts

@@ -15,6 +15,46 @@ export interface ToolRegistration<D = unknown> {
     isDocReady?: (doc: D) => boolean;
     render: (handle: DocHandle<D>, element: ToolElement) => (() => void);
 }
+/** Duck-typed doc handle — structurally compatible with automerge-repo DocHandle */
+export interface FrameDocHandle<D = unknown> {
+    url: string;
+    doc(): D | undefined;
+    whenReady(): Promise<unknown>;
+    on(event: string, cb: (...args: unknown[]) => void): void;
+    off(event: string, cb: (...args: unknown[]) => void): void;
+}
+/** Duck-typed repo — structurally compatible with automerge-repo Repo */
+export interface FrameRepo {
+    find<D = unknown>(url: string): FrameDocHandle<D>;
+    create<D = unknown>(initialValue: D): FrameDocHandle<D>;
+    delete(url: string): void;
+}
+export interface StandaloneFrameConfig {
+    /** When true, use plain automerge docs without keyhive. Default: false */
+    legacyMode?: boolean;
+    /** Pre-built repo for legacy mode. Required when legacyMode is true. */
+    repo?: FrameRepo;
+}
+export interface PluginDescription {
+    id: string;
+    type: string;
+    name: string;
+    icon?: string;
+}
+export interface ToolPlugin<D = unknown> extends PluginDescription {
+    type: "patchwork:tool";
+    supportedDatatypes: "*" | string[];
+    load: () => Promise<(handle: DocHandle<D>, element: ToolElement) => (() => void)>;
+}
+export interface DatatypePlugin<D = unknown> extends PluginDescription {
+    type: "patchwork:datatype";
+    load: () => Promise<{
+        init(doc: D, repo: Repo): void;
+        getTitle(doc: D): string;
+        setTitle?(doc: D, title: string): void;
+    }>;
+}
+export type Plugin<D = unknown> = ToolPlugin<D> | DatatypePlugin<D>;
 export { mountStandaloneApp } from "./mount.tsx";
 export { ShareModal } from "./share-modal.tsx";
 export { ConfirmModal } from "./confirm-modal.tsx";