@jtfmumm/patchwork-standalone-frame 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# @jtfmumm/patchwork-standalone-frame
+
+A reusable standalone frame for patchwork tools. Provides keyhive initialization, repo setup, doc history, access control, top bar UI, and sharing modals.
+
+## Usage
+
+```typescript
+import { mountStandaloneApp, type ToolRegistration } from "@jtfmumm/patchwork-standalone-frame";
+
+const myTool: ToolRegistration<MyDoc> = {
+  id: "my-tool",            // matches @patchwork.type
+  name: "My Tool",          // display name
+  defaultTitle: "Untitled", // placeholder for new docs
+  init: (doc, repo) => {
+    // Initialize a blank document
+  },
+  getTitle: (doc) => doc.title || "Untitled",
+  setTitle: (doc, title) => { doc.title = title; },
+  isDocReady: (doc) => !!doc?.title,
+  render: (handle, element) => {
+    // Mount your UI into `element`, return a cleanup function
+  },
+};
+
+const root = document.getElementById("root");
+if (root) mountStandaloneApp(root, myTool);
+```
+
+## Sync server
+
+The sync server URL is resolved in this order:
+1. `VITE_SYNC_URL` environment variable
+2. `tool.syncUrl` from the registration
+3. `ws://localhost:3030` (default)

package/dist/confirm-modal.d.ts

@@ -0,0 +1,10 @@
+interface ConfirmModalProps {
+    isOpen: boolean;
+    title: string;
+    message: string;
+    confirmLabel?: string;
+    onConfirm: () => void;
+    onCancel: () => void;
+}
+export declare function ConfirmModal(props: ConfirmModalProps): import("solid-js").JSX.Element;
+export {};

package/dist/doc-history.d.ts

@@ -0,0 +1,10 @@
+export interface DocHistoryEntry {
+    url: string;
+    title: string;
+    lastOpened: number;
+}
+export declare function activeDocKey(toolId: string, identityHexId: string): string;
+export declare function loadHistory(toolId: string, identityHexId: string): DocHistoryEntry[];
+export declare function upsertHistory(toolId: string, identityHexId: string, url: string, title: string): DocHistoryEntry[];
+export declare function removeFromHistory(toolId: string, identityHexId: string, url: string): DocHistoryEntry[];
+export declare function truncateUrl(url: string): string;

package/dist/frame.d.ts

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import type { Repo, DocHandle } from "@automerge/automerge-repo";
+import type { AutomergeRepoKeyhive } from "@automerge/automerge-repo-keyhive";
+export interface ToolElement extends HTMLDivElement {
+    repo: Repo;
+    hive?: AutomergeRepoKeyhive;
+}
+export interface ToolRegistration<D = unknown> {
+    id: string;
+    name: string;
+    defaultTitle: string;
+    init: (doc: D, repo: Repo) => void;
+    getTitle: (doc: D) => string;
+    syncUrl?: string;
+    setTitle?: (doc: D, title: string) => void;
+    isDocReady?: (doc: D) => boolean;
+    render: (handle: DocHandle<D>, element: ToolElement) => (() => void);
+}
+export { mountStandaloneApp } from "./mount.tsx";
+export { ShareModal } from "./share-modal.tsx";
+export { ConfirmModal } from "./confirm-modal.tsx";
+export { NewDocModal } from "./new-doc-modal.tsx";
+export { overlayStyle, cardStyle } from "./modal-styles.ts";