@molecule/app-react 1.0.0

package/dist/agent-identity.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Neutral, app-agnostic identity for the AI coding agent and the host product.
+ *
+ * The shared chat/IDE packages (`@molecule/app-react`, `@molecule/app-ide-react`)
+ * must never hardcode a specific product's agent name or product name in
+ * user-facing copy — a *different* app embedding them would inherit the wrong
+ * branding (molecule AGENTS.md anti-pattern 14 / the leaks-in-core audit).
+ * Instead, shared UI strings interpolate the i18n tokens `{{agentName}}` /
+ * `{{productName}}`, and the host supplies its own values via
+ * `useChat({ agentName })` and `<ChatPanel agentName productName />`.
+ *
+ * These NEUTRAL defaults apply when the host passes nothing, so the package on
+ * its own never names a specific product — it reads as "the assistant" / "the
+ * IDE" until a consuming app sets its own identity.
+ *
+ * @module
+ */
+/**
+ * Display identity for the AI coding agent and the host product, used to
+ * interpolate the `{{agentName}}` / `{{productName}}` tokens in shared chat/IDE
+ * copy. A consuming app sets these to its own agent + product brand names; the
+ * shared packages fall back to {@link DEFAULT_AGENT_IDENTITY} when it does not.
+ */
+export interface AgentIdentity {
+    /** Display name of the AI coding agent. Defaults to {@link DEFAULT_AGENT_NAME}. */
+    agentName: string;
+    /** Display name of the host product / IDE. Defaults to {@link DEFAULT_PRODUCT_NAME}. */
+    productName: string;
+}
+/** Neutral, product-agnostic agent name used when the host supplies none. */
+export declare const DEFAULT_AGENT_NAME = "the assistant";
+/** Neutral, product-agnostic product/IDE name used when the host supplies none. */
+export declare const DEFAULT_PRODUCT_NAME = "the IDE";
+/**
+ * The neutral default identity ({@link DEFAULT_AGENT_NAME} +
+ * {@link DEFAULT_PRODUCT_NAME}) the shared packages use until a consuming app
+ * passes its own.
+ */
+export declare const DEFAULT_AGENT_IDENTITY: AgentIdentity;
+//# sourceMappingURL=agent-identity.d.ts.map

package/dist/agent-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-identity.d.ts","sourceRoot":"","sources":["../src/agent-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAA;IACjB,wFAAwF;IACxF,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AAEjD,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,YAAY,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAGpC,CAAA"}

package/dist/agent-identity.js

@@ -0,0 +1,31 @@
+/**
+ * Neutral, app-agnostic identity for the AI coding agent and the host product.
+ *
+ * The shared chat/IDE packages (`@molecule/app-react`, `@molecule/app-ide-react`)
+ * must never hardcode a specific product's agent name or product name in
+ * user-facing copy — a *different* app embedding them would inherit the wrong
+ * branding (molecule AGENTS.md anti-pattern 14 / the leaks-in-core audit).
+ * Instead, shared UI strings interpolate the i18n tokens `{{agentName}}` /
+ * `{{productName}}`, and the host supplies its own values via
+ * `useChat({ agentName })` and `<ChatPanel agentName productName />`.
+ *
+ * These NEUTRAL defaults apply when the host passes nothing, so the package on
+ * its own never names a specific product — it reads as "the assistant" / "the
+ * IDE" until a consuming app sets its own identity.
+ *
+ * @module
+ */
+/** Neutral, product-agnostic agent name used when the host supplies none. */
+export const DEFAULT_AGENT_NAME = 'the assistant';
+/** Neutral, product-agnostic product/IDE name used when the host supplies none. */
+export const DEFAULT_PRODUCT_NAME = 'the IDE';
+/**
+ * The neutral default identity ({@link DEFAULT_AGENT_NAME} +
+ * {@link DEFAULT_PRODUCT_NAME}) the shared packages use until a consuming app
+ * passes its own.
+ */
+export const DEFAULT_AGENT_IDENTITY = {
+    agentName: DEFAULT_AGENT_NAME,
+    productName: DEFAULT_PRODUCT_NAME,
+};
+//# sourceMappingURL=agent-identity.js.map

package/dist/agent-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-identity.js","sourceRoot":"","sources":["../src/agent-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAeH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAA;AAEjD,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAA;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,SAAS,EAAE,kBAAkB;IAC7B,WAAW,EAAE,oBAAoB;CAClC,CAAA"}

package/dist/contexts.d.ts

@@ -0,0 +1,69 @@
+/**
+ * React contexts for the Molecule framework bindings.
+ *
+ * These contexts provide access to core molecule providers throughout
+ * the React component tree.
+ *
+ * @module
+ */
+import type { ChatProvider } from '@molecule/app-ai-chat';
+import type { AuthClient } from '@molecule/app-auth';
+import type { EditorProvider } from '@molecule/app-code-editor';
+import type { HttpClient } from '@molecule/app-http';
+import type { I18nProvider } from '@molecule/app-i18n';
+import type { WorkspaceProvider } from '@molecule/app-ide';
+import type { PreviewProvider } from '@molecule/app-live-preview';
+import type { LoggerProvider } from '@molecule/app-logger';
+import type { Router } from '@molecule/app-routing';
+import type { StateProvider } from '@molecule/app-state';
+import type { StorageProvider } from '@molecule/app-storage';
+import type { ThemeProvider } from '@molecule/app-theme';
+/**
+ * Context for state management provider.
+ */
+export declare const StateContext: import("react").Context<StateProvider | null>;
+/**
+ * Context for authentication client.
+ */
+export declare const AuthContext: import("react").Context<AuthClient<unknown> | null>;
+/**
+ * Context for theme provider.
+ */
+export declare const ThemeContext: import("react").Context<ThemeProvider | null>;
+/**
+ * Context for router.
+ */
+export declare const RouterContext: import("react").Context<Router | null>;
+/**
+ * Context for internationalization provider.
+ */
+export declare const I18nContext: import("react").Context<I18nProvider | null>;
+/**
+ * Context for HTTP client.
+ */
+export declare const HttpContext: import("react").Context<HttpClient | null>;
+/**
+ * Context for storage provider.
+ */
+export declare const StorageContext: import("react").Context<StorageProvider | null>;
+/**
+ * Context for logger provider.
+ */
+export declare const LoggerContext: import("react").Context<LoggerProvider | null>;
+/**
+ * Context for AI chat provider.
+ */
+export declare const ChatContext: import("react").Context<ChatProvider | null>;
+/**
+ * Context for IDE workspace provider.
+ */
+export declare const WorkspaceContext: import("react").Context<WorkspaceProvider | null>;
+/**
+ * Context for code editor provider.
+ */
+export declare const EditorContext: import("react").Context<EditorProvider | null>;
+/**
+ * Context for live preview provider.
+ */
+export declare const PreviewContext: import("react").Context<PreviewProvider | null>;
+//# sourceMappingURL=contexts.d.ts.map

package/dist/contexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contexts.d.ts","sourceRoot":"","sources":["../src/contexts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD;;GAEG;AACH,eAAO,MAAM,YAAY,+CAA4C,CAAA;AAGrE;;GAEG;AACH,eAAO,MAAM,WAAW,qDAAkD,CAAA;AAG1E;;GAEG;AACH,eAAO,MAAM,YAAY,+CAA4C,CAAA;AAGrE;;GAEG;AACH,eAAO,MAAM,aAAa,wCAAqC,CAAA;AAG/D;;GAEG;AACH,eAAO,MAAM,WAAW,8CAA2C,CAAA;AAGnE;;GAEG;AACH,eAAO,MAAM,WAAW,4CAAyC,CAAA;AAGjE;;GAEG;AACH,eAAO,MAAM,cAAc,iDAA8C,CAAA;AAGzE;;GAEG;AACH,eAAO,MAAM,aAAa,gDAA6C,CAAA;AAGvE;;GAEG;AACH,eAAO,MAAM,WAAW,8CAA2C,CAAA;AAGnE;;GAEG;AACH,eAAO,MAAM,gBAAgB,mDAAgD,CAAA;AAG7E;;GAEG;AACH,eAAO,MAAM,aAAa,gDAA6C,CAAA;AAGvE;;GAEG;AACH,eAAO,MAAM,cAAc,iDAA8C,CAAA"}

package/dist/contexts.js

@@ -0,0 +1,70 @@
+/**
+ * React contexts for the Molecule framework bindings.
+ *
+ * These contexts provide access to core molecule providers throughout
+ * the React component tree.
+ *
+ * @module
+ */
+import { createContext } from 'react';
+/**
+ * Context for state management provider.
+ */
+export const StateContext = createContext(null);
+StateContext.displayName = 'MoleculeStateContext';
+/**
+ * Context for authentication client.
+ */
+export const AuthContext = createContext(null);
+AuthContext.displayName = 'MoleculeAuthContext';
+/**
+ * Context for theme provider.
+ */
+export const ThemeContext = createContext(null);
+ThemeContext.displayName = 'MoleculeThemeContext';
+/**
+ * Context for router.
+ */
+export const RouterContext = createContext(null);
+RouterContext.displayName = 'MoleculeRouterContext';
+/**
+ * Context for internationalization provider.
+ */
+export const I18nContext = createContext(null);
+I18nContext.displayName = 'MoleculeI18nContext';
+/**
+ * Context for HTTP client.
+ */
+export const HttpContext = createContext(null);
+HttpContext.displayName = 'MoleculeHttpContext';
+/**
+ * Context for storage provider.
+ */
+export const StorageContext = createContext(null);
+StorageContext.displayName = 'MoleculeStorageContext';
+/**
+ * Context for logger provider.
+ */
+export const LoggerContext = createContext(null);
+LoggerContext.displayName = 'MoleculeLoggerContext';
+/**
+ * Context for AI chat provider.
+ */
+export const ChatContext = createContext(null);
+ChatContext.displayName = 'MoleculeChatContext';
+/**
+ * Context for IDE workspace provider.
+ */
+export const WorkspaceContext = createContext(null);
+WorkspaceContext.displayName = 'MoleculeWorkspaceContext';
+/**
+ * Context for code editor provider.
+ */
+export const EditorContext = createContext(null);
+EditorContext.displayName = 'MoleculeEditorContext';
+/**
+ * Context for live preview provider.
+ */
+export const PreviewContext = createContext(null);
+PreviewContext.displayName = 'MoleculePreviewContext';
+//# sourceMappingURL=contexts.js.map

package/dist/contexts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contexts.js","sourceRoot":"","sources":["../src/contexts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAerC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAuB,IAAI,CAAC,CAAA;AACrE,YAAY,CAAC,WAAW,GAAG,sBAAsB,CAAA;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAA6B,IAAI,CAAC,CAAA;AAC1E,WAAW,CAAC,WAAW,GAAG,qBAAqB,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAuB,IAAI,CAAC,CAAA;AACrE,YAAY,CAAC,WAAW,GAAG,sBAAsB,CAAA;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAgB,IAAI,CAAC,CAAA;AAC/D,aAAa,CAAC,WAAW,GAAG,uBAAuB,CAAA;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAsB,IAAI,CAAC,CAAA;AACnE,WAAW,CAAC,WAAW,GAAG,qBAAqB,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAoB,IAAI,CAAC,CAAA;AACjE,WAAW,CAAC,WAAW,GAAG,qBAAqB,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAyB,IAAI,CAAC,CAAA;AACzE,cAAc,CAAC,WAAW,GAAG,wBAAwB,CAAA;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAwB,IAAI,CAAC,CAAA;AACvE,aAAa,CAAC,WAAW,GAAG,uBAAuB,CAAA;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAsB,IAAI,CAAC,CAAA;AACnE,WAAW,CAAC,WAAW,GAAG,qBAAqB,CAAA;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAA;AAC7E,gBAAgB,CAAC,WAAW,GAAG,0BAA0B,CAAA;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAwB,IAAI,CAAC,CAAA;AACvE,aAAa,CAAC,WAAW,GAAG,uBAAuB,CAAA;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAyB,IAAI,CAAC,CAAA;AACzE,cAAc,CAAC,WAAW,GAAG,wBAAwB,CAAA"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * React hooks for the Molecule framework bindings.
+ *
+ * @module
+ */
+export * from './useAIModels.js';
+export * from './useAsyncState.js';
+export * from './useAuth.js';
+export * from './useCapacitorApp.js';
+export * from './useChangePassword.js';
+export * from './useChat.js';
+export * from './useDevice.js';
+export * from './useEditor.js';
+export * from './useForm.js';
+export * from './useHttp.js';
+export * from './useLogger.js';
+export * from './useLogin.js';
+export * from './useOAuth.js';
+export * from './usePasswordReset.js';
+export * from './usePlatform.js';
+export * from './usePreview.js';
+export * from './usePromise.js';
+export * from './usePush.js';
+export * from './useRouter.js';
+export * from './useSignup.js';
+export * from './useStorage.js';
+export * from './useStore.js';
+export * from './useTheme.js';
+export * from './useTranslation.js';
+export * from './useVersion.js';
+export * from './useWorkspace.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA"}

package/dist/hooks/index.js

@@ -0,0 +1,32 @@
+/**
+ * React hooks for the Molecule framework bindings.
+ *
+ * @module
+ */
+export * from './useAIModels.js';
+export * from './useAsyncState.js';
+export * from './useAuth.js';
+export * from './useCapacitorApp.js';
+export * from './useChangePassword.js';
+export * from './useChat.js';
+export * from './useDevice.js';
+export * from './useEditor.js';
+export * from './useForm.js';
+export * from './useHttp.js';
+export * from './useLogger.js';
+export * from './useLogin.js';
+export * from './useOAuth.js';
+export * from './usePasswordReset.js';
+export * from './usePlatform.js';
+export * from './usePreview.js';
+export * from './usePromise.js';
+export * from './usePush.js';
+export * from './useRouter.js';
+export * from './useSignup.js';
+export * from './useStorage.js';
+export * from './useStore.js';
+export * from './useTheme.js';
+export * from './useTranslation.js';
+export * from './useVersion.js';
+export * from './useWorkspace.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA"}

package/dist/hooks/useAIModels.d.ts

@@ -0,0 +1,48 @@
+/**
+ * React hook for the AI model catalog.
+ *
+ * Lazily fetches `GET /ai/models` on first mount and caches the result in a
+ * module-level singleton so subsequent mounts return synchronously. The picker
+ * shows a brief loading state on first open and never refetches afterwards.
+ *
+ * When a `projectId` is passed, the fetch is project-scoped
+ * (`?projectId=<id>`) so servers that support per-project custom
+ * ("bring your own AI") models include them; each scope caches independently.
+ *
+ * @module
+ */
+import type { AppModelDefinition, AppModeModelDefaults } from '@molecule/app-ai-models';
+/**
+ * Test-only: drops every cached model list so the next `useAIModels` call
+ * refetches. Exposed for unit tests; do not call from production code.
+ */
+export declare function resetAIModelsCache(): void;
+/**
+ * Result returned by `useAIModels`.
+ */
+export interface UseAIModelsResult {
+    /** Available models, or an empty array while loading. */
+    models: AppModelDefinition[];
+    /**
+     * Per-mode server default model ids for the requester's tier, or `undefined`
+     * while loading or on servers that don't provide them.
+     */
+    defaults: AppModeModelDefaults | undefined;
+    /** The single model marked `freeTier: true`, or `undefined`. */
+    freeTierModel: AppModelDefinition | undefined;
+    /** `true` while the initial fetch is in flight. */
+    loading: boolean;
+    /** Error from the initial fetch, or `null`. */
+    error: Error | null;
+}
+/**
+ * Subscribes to the cached AI model catalog. The first mount of a scope
+ * triggers a single `GET /ai/models` fetch; subsequent mounts return the
+ * cached result.
+ *
+ * @param projectId - Optional project scope: includes that project's custom
+ *   ("bring your own AI") models on servers that support them.
+ * @returns Models, free-tier model, loading flag, and error.
+ */
+export declare function useAIModels(projectId?: string): UseAIModelsResult;
+//# sourceMappingURL=useAIModels.d.ts.map

package/dist/hooks/useAIModels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAIModels.d.ts","sourceRoot":"","sources":["../../src/hooks/useAIModels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAkGvF;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CASzC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,MAAM,EAAE,kBAAkB,EAAE,CAAA;IAC5B;;;OAGG;IACH,QAAQ,EAAE,oBAAoB,GAAG,SAAS,CAAA;IAC1C,gEAAgE;IAChE,aAAa,EAAE,kBAAkB,GAAG,SAAS,CAAA;IAC7C,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAA;IAChB,+CAA+C;IAC/C,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAsCjE"}

package/dist/hooks/useAIModels.js

@@ -0,0 +1,145 @@
+/**
+ * React hook for the AI model catalog.
+ *
+ * Lazily fetches `GET /ai/models` on first mount and caches the result in a
+ * module-level singleton so subsequent mounts return synchronously. The picker
+ * shows a brief loading state on first open and never refetches afterwards.
+ *
+ * When a `projectId` is passed, the fetch is project-scoped
+ * (`?projectId=<id>`) so servers that support per-project custom
+ * ("bring your own AI") models include them; each scope caches independently.
+ *
+ * @module
+ */
+import { useEffect, useState } from 'react';
+import { loadAIModelCatalog, pickFreeTierModel } from '@molecule/app-ai-models';
+import { useHttpClient } from './useHttp.js';
+/** One cache entry per scope — `''` for the unscoped catalog, else the projectId. */
+const caches = new Map();
+/**
+ * The cache entry for a scope, created on first use.
+ *
+ * @param scope - `''` for the unscoped catalog, else the projectId.
+ * @returns The scope's cache entry.
+ */
+function cacheFor(scope) {
+    let cache = caches.get(scope);
+    if (!cache) {
+        cache = { models: null, defaults: undefined, error: null, inFlight: null };
+        caches.set(scope, cache);
+    }
+    return cache;
+}
+/** Listeners keyed by the same scope as the cache they observe. */
+const listenersByScope = new Map();
+/**
+ * The listener set for a scope, created on first use.
+ *
+ * @param scope - The cache scope.
+ * @returns The scope's listener set.
+ */
+function listenersFor(scope) {
+    let set = listenersByScope.get(scope);
+    if (!set) {
+        set = new Set();
+        listenersByScope.set(scope, set);
+    }
+    return set;
+}
+/**
+ * Broadcasts a scope's current cache state to its subscribed listeners.
+ *
+ * @param scope - The cache scope to notify.
+ */
+function notify(scope) {
+    const cache = cacheFor(scope);
+    for (const listener of listenersFor(scope)) {
+        listener({ models: cache.models, defaults: cache.defaults, error: cache.error });
+    }
+}
+/**
+ * Triggers (or rejoins) the single in-flight fetch of `/ai/models` for a scope
+ * and stores the result in that scope's module-level cache.
+ *
+ * @param http - HTTP client used for the single fetch.
+ * @param scope - `''` for the unscoped catalog, else the projectId.
+ * @returns The fetched model list.
+ */
+async function fetchOnce(http, scope) {
+    const cache = cacheFor(scope);
+    if (cache.models)
+        return cache.models;
+    if (cache.inFlight)
+        return cache.inFlight;
+    cache.inFlight = loadAIModelCatalog(http, undefined, scope || undefined)
+        .then((catalog) => {
+        cache.models = catalog.models;
+        cache.defaults = catalog.defaults;
+        cache.error = null;
+        cache.inFlight = null;
+        notify(scope);
+        return catalog.models;
+    })
+        .catch((err) => {
+        cache.error = err instanceof Error ? err : new Error(String(err));
+        cache.inFlight = null;
+        notify(scope);
+        throw cache.error;
+    });
+    return cache.inFlight;
+}
+/**
+ * Test-only: drops every cached model list so the next `useAIModels` call
+ * refetches. Exposed for unit tests; do not call from production code.
+ */
+export function resetAIModelsCache() {
+    for (const [scope, cache] of caches) {
+        cache.models = null;
+        cache.defaults = undefined;
+        cache.error = null;
+        cache.inFlight = null;
+        notify(scope);
+    }
+    caches.clear();
+}
+/**
+ * Subscribes to the cached AI model catalog. The first mount of a scope
+ * triggers a single `GET /ai/models` fetch; subsequent mounts return the
+ * cached result.
+ *
+ * @param projectId - Optional project scope: includes that project's custom
+ *   ("bring your own AI") models on servers that support them.
+ * @returns Models, free-tier model, loading flag, and error.
+ */
+export function useAIModels(projectId) {
+    const http = useHttpClient();
+    const scope = projectId ?? '';
+    const [snapshot, setSnapshot] = useState(() => {
+        const cache = cacheFor(scope);
+        return { models: cache.models, defaults: cache.defaults, error: cache.error };
+    });
+    useEffect(() => {
+        const cache = cacheFor(scope);
+        const listener = (next) => setSnapshot(next);
+        listenersFor(scope).add(listener);
+        // The scope may have changed since the lazy useState init — resync.
+        setSnapshot({ models: cache.models, defaults: cache.defaults, error: cache.error });
+        if (!cache.models && !cache.error) {
+            void fetchOnce(http, scope).catch(() => {
+                // Error is mirrored into cache.error and propagated via the listener.
+            });
+        }
+        return () => {
+            listenersFor(scope).delete(listener);
+        };
+    }, [http, scope]);
+    const models = snapshot.models ?? [];
+    return {
+        models,
+        defaults: snapshot.defaults,
+        freeTierModel: pickFreeTierModel(models),
+        loading: !snapshot.models && !snapshot.error,
+        error: snapshot.error,
+    };
+}
+//# sourceMappingURL=useAIModels.js.map

package/dist/hooks/useAIModels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAIModels.js","sourceRoot":"","sources":["../../src/hooks/useAIModels.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useAsyncState.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Async-capable setState function.
+ * @param value - The new state value, an updater function receiving previous state, or a Promise resolving to either.
+ */
+export type AsyncSetState<T> = (value: T | ((prev: T) => T) | Promise<T | ((prev: T) => T)>) => void;
+/**
+ * Async-capable extendState function for partial updates.
+ */
+export type AsyncExtendState<T> = (partial: Partial<T> | ((prev: T) => Partial<T>) | Promise<Partial<T> | ((prev: T) => Partial<T>)>) => void;
+/**
+ * Hook like useState but accepts Promises and supports partial state extension.
+ *
+ * @param initialState - Initial state value
+ * @returns Tuple of [state, asyncSetState, asyncExtendState]
+ *
+ * @example
+ * ```tsx
+ * interface State {
+ *   foo: string
+ *   bar: string
+ * }
+ *
+ * const [state, setState, extendState] = useAsyncState<State>({
+ *   foo: 'foo',
+ *   bar: 'bar',
+ * })
+ *
+ * // Synchronous usage
+ * setState({ foo: 'Hello', bar: 'World!' })
+ * setState((prev) => ({ ...prev, foo: prev.foo.toUpperCase() }))
+ *
+ * // Async usage
+ * setState(fetchData())
+ *
+ * // Partial updates
+ * extendState({ foo: 'Hello' })
+ * extendState(fetchPartialData())
+ * ```
+ */
+export declare const useAsyncState: <T>(initialState: T) => [T, AsyncSetState<T>, AsyncExtendState<T>];
+//# sourceMappingURL=useAsyncState.d.ts.map

package/dist/hooks/useAsyncState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncState.d.ts","sourceRoot":"","sources":["../../src/hooks/useAsyncState.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;AAEpG;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAChC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAC9F,IAAI,CAAA;AAET;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,cAAc,CAAC,KAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CA2C3F,CAAA"}

package/dist/hooks/useAsyncState.js

@@ -0,0 +1,77 @@
+/**
+ * React hook for async-capable state management.
+ *
+ * @module
+ */
+import { useCallback, useState } from 'react';
+/**
+ * Hook like useState but accepts Promises and supports partial state extension.
+ *
+ * @param initialState - Initial state value
+ * @returns Tuple of [state, asyncSetState, asyncExtendState]
+ *
+ * @example
+ * ```tsx
+ * interface State {
+ *   foo: string
+ *   bar: string
+ * }
+ *
+ * const [state, setState, extendState] = useAsyncState<State>({
+ *   foo: 'foo',
+ *   bar: 'bar',
+ * })
+ *
+ * // Synchronous usage
+ * setState({ foo: 'Hello', bar: 'World!' })
+ * setState((prev) => ({ ...prev, foo: prev.foo.toUpperCase() }))
+ *
+ * // Async usage
+ * setState(fetchData())
+ *
+ * // Partial updates
+ * extendState({ foo: 'Hello' })
+ * extendState(fetchPartialData())
+ * ```
+ */
+export const useAsyncState = (initialState) => {
+    const [state, setState] = useState(initialState);
+    const asyncSetState = useCallback(async (nextState) => {
+        try {
+            if (nextState instanceof Promise) {
+                nextState = await nextState;
+            }
+            setState((prev) => {
+                if (typeof nextState === 'function') {
+                    return nextState(prev);
+                }
+                return nextState;
+            });
+        }
+        catch (_error) {
+            // Silently swallow errors from resolved Promises to avoid unhandled rejections
+        }
+    }, []);
+    const asyncExtendState = useCallback(async (partial) => {
+        try {
+            if (partial instanceof Promise) {
+                partial = await partial;
+            }
+            setState((prev) => {
+                let resolved;
+                if (typeof partial === 'function') {
+                    resolved = partial(prev);
+                }
+                else {
+                    resolved = partial;
+                }
+                return { ...prev, ...resolved };
+            });
+        }
+        catch (_error) {
+            // Silently swallow errors from resolved Promises to avoid unhandled rejections
+        }
+    }, []);
+    return [state, asyncSetState, asyncExtendState];
+};
+//# sourceMappingURL=useAsyncState.js.map

package/dist/hooks/useAsyncState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncState.js","sourceRoot":"","sources":["../../src/hooks/useAsyncState.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAe7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAI,YAAe,EAA8C,EAAE;IAC9F,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAI,YAAY,CAAC,CAAA;IAEnD,MAAM,aAAa,GAAG,WAAW,CAAmB,KAAK,EAAE,SAAS,EAAE,EAAE;QACtE,IAAI,CAAC;YACH,IAAI,SAAS,YAAY,OAAO,EAAE,CAAC;gBACjC,SAAS,GAAG,MAAM,SAAS,CAAA;YAC7B,CAAC;YAED,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;gBAChB,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;oBACpC,OAAQ,SAA4B,CAAC,IAAI,CAAC,CAAA;gBAC5C,CAAC;gBACD,OAAO,SAAc,CAAA;YACvB,CAAC,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,+EAA+E;QACjF,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,gBAAgB,GAAG,WAAW,CAAsB,KAAK,EAAE,OAAO,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;gBAC/B,OAAO,GAAG,MAAM,OAAO,CAAA;YACzB,CAAC;YAED,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;gBAChB,IAAI,QAAoB,CAAA;gBAExB,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;oBAClC,QAAQ,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAA;gBACvD,CAAC;qBAAM,CAAC;oBACN,QAAQ,GAAG,OAAqB,CAAA;gBAClC,CAAC;gBAED,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAA;YACjC,CAAC,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,+EAA+E;QACjF,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAA;AACjD,CAAC,CAAA"}