@seedprotocol/react 0.4.15

package/dist/OPFSFilesManager.d.ts

@@ -0,0 +1,45 @@
+import { OPFSFile } from './useOPFSFiles';
+export type OPFSFilesManagerTheme = 'light' | 'dark';
+export interface OPFSFilesManagerProps {
+    /** Optional subdirectory to scan (e.g. 'app-files'). Default: root. */
+    rootPath?: string;
+    /** Filter which files to include. */
+    filter?: (file: OPFSFile) => boolean;
+    /** Called when a file is about to be deleted. Return false to cancel. */
+    onBeforeDelete?: (file: OPFSFile) => boolean | Promise<boolean>;
+    /** Called after a file or files are deleted. Use for clearing app state (e.g. Seed DB). */
+    onAfterDelete?: (paths: string[]) => void | Promise<void>;
+    /** Custom download handler (e.g. Electron). If not provided, uses browser blob download. */
+    onDownload?: (file: OPFSFile, blob: Blob) => void | Promise<void>;
+    /** Title for the page. Default: "Files" */
+    title?: string;
+    /** Description text. Default: OPFS description. */
+    description?: string;
+    /** Visual theme. Default: "dark" */
+    theme?: OPFSFilesManagerTheme;
+    /** Class for the container. */
+    className?: string;
+}
+/**
+ * A React component to browse, download, and delete files stored in OPFS.
+ * Useful for debugging and managing Origin Private File System storage.
+ *
+ * @example
+ * ```tsx
+ * <OPFSFilesManager
+ *   onAfterDelete={(paths) => {
+ *     if (paths.some(isSeedDbPath)) {
+ *       clearSeedDependentData()
+ *       window.location.reload()
+ *     }
+ *   }}
+ *   onDownload={async (file, blob) => {
+ *     if (window.electron?.downloadFile) {
+ *       await window.electron.downloadFile({ data: await blob.arrayBuffer(), filename: file.name })
+ *     }
+ *   }}
+ * />
+ * ```
+ */
+export declare function OPFSFilesManager({ rootPath, filter, onBeforeDelete, onAfterDelete, onDownload, title, description, theme, className, }: OPFSFilesManagerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=OPFSFilesManager.d.ts.map

package/dist/OPFSFilesManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OPFSFilesManager.d.ts","sourceRoot":"","sources":["../src/OPFSFilesManager.tsx"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAwF5D,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,CAAA;AAEpD,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qCAAqC;IACrC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAA;IACpC,yEAAyE;IACzE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/D,2FAA2F;IAC3F,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,4FAA4F;IAC5F,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oCAAoC;IACpC,KAAK,CAAC,EAAE,qBAAqB,CAAA;IAC7B,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAuED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EACN,cAAc,EACd,aAAa,EACb,UAAU,EACV,KAAe,EACf,WAA8F,EAC9F,KAAc,EACd,SAAS,GACV,EAAE,qBAAqB,2CA2RvB"}

package/dist/OPFSImage.d.ts

@@ -0,0 +1,7 @@
+import { default as React, HTMLAttributes } from 'react';
+type OPFSImageProps = HTMLAttributes<HTMLImageElement> & {
+    filename: string;
+};
+declare const OPFSImage: React.FC<OPFSImageProps>;
+export default OPFSImage;
+//# sourceMappingURL=OPFSImage.d.ts.map

package/dist/OPFSImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OPFSImage.d.ts","sourceRoot":"","sources":["../src/OPFSImage.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAuB,cAAc,EAAE,MAAM,OAAO,CAAC;AAKnE,KAAK,cAAc,GAAG,cAAc,CAAC,gBAAgB,CAAC,GAAG;IACrD,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAGF,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAyEvC,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/SeedClientGate.d.ts

@@ -0,0 +1,28 @@
+import { ReactNode } from 'react';
+import { SeedConstructorOptions, SchemaFileFormat } from '@seedprotocol/sdk';
+/** Schema input: path string or SchemaFileFormat object. Merged into config.schema at init. */
+type SchemaInput = string | SchemaFileFormat;
+export type SeedClientGateProps = {
+    /** Seed client init options (config + addresses). Required. */
+    initConfig: SeedConstructorOptions;
+    /** Optional canonical schema. When provided, merged into config.schema and loaded at init (no separate import). */
+    schema?: SchemaInput;
+    /** Custom loading UI. Default: simple centered "Loading..." text. */
+    loadingComponent?: ReactNode;
+    /** @deprecated Schema is now loaded at init via config.schema; no separate import. Kept for backward compatibility. */
+    onSchemaImportError?: (err: unknown) => void;
+    /** Class for the root wrapper. e.g. "relative flex h-screen w-screen" */
+    wrapperClassName?: string;
+    /** Class for the loading overlay. e.g. "absolute inset-0 z-50 flex items-center justify-center bg-zinc-950" */
+    loadingClassName?: string;
+    children: ReactNode;
+};
+/**
+ * Gates children until the Seed client is initialized and optionally imports a schema.
+ * Mounted inside RouterProvider so we never swap the router—only the route content.
+ * This avoids removeChild DOM errors and ensures QueryClientProvider stays stable.
+ * Both overlay and content stay in DOM; we only toggle visibility via classes.
+ */
+export declare function SeedClientGate({ initConfig, schema, loadingComponent, wrapperClassName, loadingClassName, children, }: SeedClientGateProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=SeedClientGate.d.ts.map

package/dist/SeedClientGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedClientGate.d.ts","sourceRoot":"","sources":["../src/SeedClientGate.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAExD,OAAO,KAAK,EAAE,sBAAsB,EAAc,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAG7F,+FAA+F;AAC/F,KAAK,WAAW,GAAG,MAAM,GAAG,gBAAgB,CAAA;AAkB5C,MAAM,MAAM,mBAAmB,GAAG;IAChC,+DAA+D;IAC/D,UAAU,EAAE,sBAAsB,CAAA;IAClC,mHAAmH;IACnH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,SAAS,CAAA;IAC5B,uHAAuH;IACvH,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;IAC5C,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,+GAA+G;IAC/G,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,MAAM,EACN,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,GACT,EAAE,mBAAmB,2CAqDrB"}

package/dist/SeedImage.d.ts

@@ -0,0 +1,13 @@
+import { default as React, DetailedHTMLProps, ImgHTMLAttributes } from 'react';
+import { ItemProperty } from '@seedprotocol/sdk';
+type SeedImageProps = DetailedHTMLProps<ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement> & {
+    imageProperty: ItemProperty<any>;
+    alt?: string;
+    width?: number;
+    height?: number;
+    /** Optional filename override when property hasn't resolved yet (e.g. in tests) */
+    filename?: string;
+};
+export declare const SeedImage: React.MemoExoticComponent<({ imageProperty, width, filename: filenameOverride, ...props }: SeedImageProps) => React.ReactNode>;
+export {};
+//# sourceMappingURL=SeedImage.d.ts.map

package/dist/SeedImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedImage.d.ts","sourceRoot":"","sources":["../src/SeedImage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAuB,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAIxF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AA0ChD,KAAK,cAAc,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,GAAG;IAC/F,aAAa,EAAE,YAAY,CAAC,GAAG,CAAC,CAAA;IAChC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAmJD,eAAO,MAAM,SAAS,6FAjJkE,cAAc,KAAG,KAAK,CAAC,SAAS,CAqJvH,CAAA"}

package/dist/SeedProvider.d.ts

@@ -0,0 +1,30 @@
+import { default as React, ReactNode } from 'react';
+import { QueryClient } from '@tanstack/react-query';
+export type SeedProviderProps = {
+    children: ReactNode;
+    /** Optional: use your own QueryClient. If not provided, a default client with Seed options is created. */
+    queryClient?: QueryClient;
+    /** Optional: ref to receive the QueryClient instance (e.g. for tests). */
+    queryClientRef?: React.MutableRefObject<QueryClient | null>;
+};
+declare global {
+    interface Window {
+        __SEED_INVALIDATE_ITEM_PROPERTIES__?: ((canonicalId: string) => void) | null;
+    }
+}
+/**
+ * Invalidates and refetches the item-properties query for an item.
+ * Call this after updating an ItemProperty (e.g. after save()) so useItemProperties
+ * refetches and the UI updates. Returns a Promise that resolves when the refetch has completed (if available).
+ */
+export declare function invalidateItemPropertiesForItem(canonicalId: string): Promise<void>;
+/**
+ * Provider that supplies a React Query client to Seed list hooks (useSchemas, useItems, useModels, etc.)
+ * so results are cached and shared across components. Wrap your app (or the subtree that uses Seed hooks)
+ * after calling client.init().
+ *
+ * - No props: uses an internal QueryClient with Seed defaults.
+ * - queryClient prop: use your own client (e.g. merge getSeedQueryDefaultOptions when creating it).
+ */
+export declare function SeedProvider({ children, queryClient: queryClientProp, queryClientRef }: SeedProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SeedProvider.d.ts.map

package/dist/SeedProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedProvider.d.ts","sourceRoot":"","sources":["../src/SeedProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAsB,MAAM,OAAO,CAAA;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAIxD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,SAAS,CAAA;IACnB,0GAA0G;IAC1G,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;CAC5D,CAAA;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,mCAAmC,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;KAC7E;CACF;AAKD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlF;AA+BD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,EAAE,iBAAiB,2CAuBzG"}

package/dist/client.d.ts

@@ -0,0 +1,2 @@
+export declare const useIsClientReady: () => boolean;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,eAW5B,CAAA"}

package/dist/db.d.ts

@@ -0,0 +1,4 @@
+export declare const useDbsAreReady: () => {
+    dbsAreReady: boolean;
+};
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,cAAc;;CAuD1B,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export * from './item';
+export * from './itemProperty';
+export * from './services';
+export * from './db';
+export * from './schema';
+export * from './modelProperty';
+export { useDeleteItem } from './trash';
+export { useImageFiles } from './useImageFiles';
+export { useFiles, FILES_QUERY_KEY_PREFIX } from './useFiles';
+export { useModels, useModel, useCreateModel, useDestroyModel } from './model';
+export { useLiveQuery } from './liveQuery';
+export { SeedProvider, invalidateItemPropertiesForItem } from './SeedProvider';
+export type { SeedProviderProps } from './SeedProvider';
+export { SeedClientGate } from './SeedClientGate';
+export type { SeedClientGateProps } from './SeedClientGate';
+export { OPFSFilesManager } from './OPFSFilesManager';
+export type { OPFSFilesManagerProps, OPFSFilesManagerTheme } from './OPFSFilesManager';
+export { useOPFSFiles } from './useOPFSFiles';
+export type { OPFSFile, UseOPFSFilesOptions } from './useOPFSFiles';
+export { createSeedQueryClient, getSeedQueryDefaultOptions, mergeSeedQueryDefaults, } from './queryClient';
+export { SeedImage } from './SeedImage';
+//# 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,cAAc,QAAQ,CAAA;AACtB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,MAAM,CAAA;AACpB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAA;AAC9E,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}