@sudobility/sudojo_lib 0.0.201 → 0.0.203

package/dist/admin/useSingleBoardExtractor.js

@@ -0,0 +1,19 @@
+/**
+ * Admin: extract one board's techniques, or find a technique example in it.
+ */
+import { useCallback, useRef } from 'react';
+import { useAdminApi } from './adminApi';
+import { extractBoardTechniques, } from './extraction';
+export function useSingleBoardExtractor(options) {
+    const api = useAdminApi(options.networkClient, options.baseUrl);
+    const getTokenRef = useRef(options.getToken);
+    getTokenRef.current = options.getToken;
+    const extract = useCallback(async (original, desiredTechnique) => {
+        const token = await getTokenRef.current();
+        if (!token)
+            return { error: 'Not authenticated' };
+        return extractBoardTechniques(opts => api.solve(token, opts), original, desiredTechnique);
+    }, [api]);
+    return { extract };
+}
+//# sourceMappingURL=useSingleBoardExtractor.js.map

package/dist/admin/useSingleBoardExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSingleBoardExtractor.js","sourceRoot":"","sources":["../../src/admin/useSingleBoardExtractor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAEL,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAkBtB,MAAM,UAAU,uBAAuB,CACrC,OAAuC;IAEvC,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7C,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAEvC,MAAM,OAAO,GAAG,WAAW,CACzB,KAAK,EACH,QAAgB,EAChB,gBAA8B,EACG,EAAE;QACnC,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAClD,OAAO,sBAAsB,CAC3B,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,EAC9B,QAAQ,EACR,gBAAgB,CACjB,CAAC;IACJ,CAAC,EACD,CAAC,GAAG,CAAC,CACN,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC","sourcesContent":["/**\n * Admin: extract one board's techniques, or find a technique example in it.\n */\n\nimport type { TechniqueId } from '@sudobility/sudojo_types';\nimport { useCallback, useRef } from 'react';\nimport { useAdminApi } from './adminApi';\nimport {\n  type BoardExtractionOutcome,\n  extractBoardTechniques,\n} from './extraction';\nimport type { AdminJobOptions } from './types';\n\nexport type UseSingleBoardExtractorOptions = AdminJobOptions;\n\nexport interface UseSingleBoardExtractorResult {\n  /**\n   * Walk `original` with /solve. Without `desiredTechnique`: the accumulated\n   * `{ techniques, level }`. With it: `{ type: 'found', … }` at the first\n   * matching hint, else the accumulated result. `{ error }` on invalid\n   * pencilmarks, a 400, no token, or after 200 steps.\n   */\n  extract: (\n    original: string,\n    desiredTechnique?: TechniqueId\n  ) => Promise<BoardExtractionOutcome>;\n}\n\nexport function useSingleBoardExtractor(\n  options: UseSingleBoardExtractorOptions\n): UseSingleBoardExtractorResult {\n  const api = useAdminApi(options.networkClient, options.baseUrl);\n  const getTokenRef = useRef(options.getToken);\n  getTokenRef.current = options.getToken;\n\n  const extract = useCallback(\n    async (\n      original: string,\n      desiredTechnique?: TechniqueId\n    ): Promise<BoardExtractionOutcome> => {\n      const token = await getTokenRef.current();\n      if (!token) return { error: 'Not authenticated' };\n      return extractBoardTechniques(\n        opts => api.solve(token, opts),\n        original,\n        desiredTechnique\n      );\n    },\n    [api]\n  );\n\n  return { extract };\n}\n"]}

package/dist/admin/useTechniqueExtractor.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Admin: fill in the techniques bitmask and level of boards that lack them.
+ */
+import type { AdminJobOptions, AdminJobState } from './types';
+export type UseTechniqueExtractorOptions = AdminJobOptions;
+export interface UseTechniqueExtractorResult extends AdminJobState {
+    /** Boards saved by the current/last run. */
+    extractedCount: number;
+    /**
+     * Start extracting. `testWithFrontend`: walk each board with /solve and
+     * compare with /validate (stops on a mismatch) instead of trusting
+     * /validate. Resolves with the number saved when the run ends.
+     */
+    start: (options: {
+        testWithFrontend: boolean;
+    }) => Promise<number>;
+    /** Stop now: shows "Stopped" and ignores the board in flight. */
+    cancel: () => void;
+}
+/**
+ * Process boards without techniques until none are left, `cancel()`, or a
+ * critical error. Board counts refresh on their own (each save invalidates
+ * sudojo_client's `boards` queries).
+ */
+export declare function useTechniqueExtractor(options: UseTechniqueExtractorOptions): UseTechniqueExtractorResult;
+//# sourceMappingURL=useTechniqueExtractor.d.ts.map

package/dist/admin/useTechniqueExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTechniqueExtractor.d.ts","sourceRoot":"","sources":["../../src/admin/useTechniqueExtractor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG9D,MAAM,MAAM,4BAA4B,GAAG,eAAe,CAAC;AAE3D,MAAM,WAAW,2BAA4B,SAAQ,aAAa;IAChE,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE;QAAE,gBAAgB,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,iEAAiE;IACjE,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,2BAA2B,CAiC7B"}

package/dist/admin/useTechniqueExtractor.js

@@ -0,0 +1,37 @@
+/**
+ * Admin: fill in the techniques bitmask and level of boards that lack them.
+ */
+import { useCallback, useRef, useState } from 'react';
+import { useAdminApi } from './adminApi';
+import { runTechniqueExtraction } from './jobs';
+import { useAdminJob } from './useAdminJob';
+/**
+ * Process boards without techniques until none are left, `cancel()`, or a
+ * critical error. Board counts refresh on their own (each save invalidates
+ * sudojo_client's `boards` queries).
+ */
+export function useTechniqueExtractor(options) {
+    const api = useAdminApi(options.networkClient, options.baseUrl);
+    const job = useAdminJob();
+    const [extractedCount, setExtractedCount] = useState(0);
+    const getTokenRef = useRef(options.getToken);
+    getTokenRef.current = options.getToken;
+    const { run, cancel: cancelJob } = job;
+    const start = useCallback(async ({ testWithFrontend }) => {
+        setExtractedCount(0);
+        const count = await run(api, () => getTokenRef.current(), (ctx, isLive) => {
+            ctx.onProgress('Starting extraction...');
+            return runTechniqueExtraction(ctx, {
+                testWithFrontend,
+                onBoardExtracted: () => {
+                    if (isLive())
+                        setExtractedCount(n => n + 1);
+                },
+            });
+        });
+        return count ?? 0;
+    }, [api, run]);
+    const cancel = useCallback(() => cancelJob(true), [cancelJob]);
+    return { ...job.state, extractedCount, start, cancel };
+}
+//# sourceMappingURL=useTechniqueExtractor.js.map

package/dist/admin/useTechniqueExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTechniqueExtractor.js","sourceRoot":"","sources":["../../src/admin/useTechniqueExtractor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAiB5C;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAqC;IAErC,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;IAC1B,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7C,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAEvC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC;IAEvC,MAAM,KAAK,GAAG,WAAW,CACvB,KAAK,EAAE,EAAE,gBAAgB,EAAiC,EAAE,EAAE;QAC5D,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,MAAM,GAAG,CACrB,GAAG,EACH,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAC3B,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YACd,GAAG,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC;YACzC,OAAO,sBAAsB,CAAC,GAAG,EAAE;gBACjC,gBAAgB;gBAChB,gBAAgB,EAAE,GAAG,EAAE;oBACrB,IAAI,MAAM,EAAE;wBAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9C,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CACF,CAAC;QACF,OAAO,KAAK,IAAI,CAAC,CAAC;IACpB,CAAC,EACD,CAAC,GAAG,EAAE,GAAG,CAAC,CACX,CAAC;IAEF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAE/D,OAAO,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACzD,CAAC","sourcesContent":["/**\n * Admin: fill in the techniques bitmask and level of boards that lack them.\n */\n\nimport { useCallback, useRef, useState } from 'react';\nimport { useAdminApi } from './adminApi';\nimport { runTechniqueExtraction } from './jobs';\nimport type { AdminJobOptions, AdminJobState } from './types';\nimport { useAdminJob } from './useAdminJob';\n\nexport type UseTechniqueExtractorOptions = AdminJobOptions;\n\nexport interface UseTechniqueExtractorResult extends AdminJobState {\n  /** Boards saved by the current/last run. */\n  extractedCount: number;\n  /**\n   * Start extracting. `testWithFrontend`: walk each board with /solve and\n   * compare with /validate (stops on a mismatch) instead of trusting\n   * /validate. Resolves with the number saved when the run ends.\n   */\n  start: (options: { testWithFrontend: boolean }) => Promise<number>;\n  /** Stop now: shows \"Stopped\" and ignores the board in flight. */\n  cancel: () => void;\n}\n\n/**\n * Process boards without techniques until none are left, `cancel()`, or a\n * critical error. Board counts refresh on their own (each save invalidates\n * sudojo_client's `boards` queries).\n */\nexport function useTechniqueExtractor(\n  options: UseTechniqueExtractorOptions\n): UseTechniqueExtractorResult {\n  const api = useAdminApi(options.networkClient, options.baseUrl);\n  const job = useAdminJob();\n  const [extractedCount, setExtractedCount] = useState(0);\n  const getTokenRef = useRef(options.getToken);\n  getTokenRef.current = options.getToken;\n\n  const { run, cancel: cancelJob } = job;\n\n  const start = useCallback(\n    async ({ testWithFrontend }: { testWithFrontend: boolean }) => {\n      setExtractedCount(0);\n      const count = await run(\n        api,\n        () => getTokenRef.current(),\n        (ctx, isLive) => {\n          ctx.onProgress('Starting extraction...');\n          return runTechniqueExtraction(ctx, {\n            testWithFrontend,\n            onBoardExtracted: () => {\n              if (isLive()) setExtractedCount(n => n + 1);\n            },\n          });\n        }\n      );\n      return count ?? 0;\n    },\n    [api, run]\n  );\n\n  const cancel = useCallback(() => cancelJob(true), [cancelJob]);\n\n  return { ...job.state, extractedCount, start, cancel };\n}\n"]}

package/dist/context/SudojoApiContext.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SudojoApiContext
+ *
+ * Optional React context that supplies the API connection (network client,
+ * base URL, auth token) to sudojo_lib hooks. Apps wrap their tree with
+ * SudojoApiProvider once; hooks whose options carry `networkClient` /
+ * `baseUrl` / `token` may then omit them. Explicit options always win over
+ * the context, so existing callers keep working unchanged.
+ */
+import type { NetworkClient } from '@sudobility/types';
+/** The API connection the provider supplies. */
+export interface SudojoApiValue {
+    /** Network client for API calls */
+    networkClient: NetworkClient;
+    /** Base URL for the Sudojo API */
+    baseUrl: string;
+    /** Firebase ID token, or null/undefined when signed out */
+    token?: string | null | undefined;
+}
+/** Optional API connection fields a hook's options may carry. */
+export interface SudojoApiOptions {
+    /** Network client for API calls (default: SudojoApiProvider's) */
+    networkClient?: NetworkClient | undefined;
+    /** Base URL for the Sudojo API (default: SudojoApiProvider's) */
+    baseUrl?: string | undefined;
+    /** Access token (default: SudojoApiProvider's, else '') */
+    token?: string | null | undefined;
+}
+/** An API connection with every field resolved. */
+export interface ResolvedSudojoApi {
+    networkClient: NetworkClient;
+    baseUrl: string;
+    /** The token, '' when there is none */
+    token: string;
+}
+declare const SudojoApiContext: import("react").Context<SudojoApiValue | null>;
+/**
+ * The API connection from the nearest SudojoApiProvider.
+ * @throws Error when there is no SudojoApiProvider above
+ */
+export declare function useSudojoApi(): SudojoApiValue;
+/** The API connection from the nearest SudojoApiProvider, or null. */
+export declare function useOptionalSudojoApi(): SudojoApiValue | null;
+/**
+ * Merge explicit options over the provider's connection (pure; no hooks).
+ * `token` falls back to the provider only when the option is undefined, so an
+ * explicit null or '' means "no token".
+ * @throws Error when neither supplies networkClient and baseUrl
+ */
+export declare function resolveSudojoApi(options: SudojoApiOptions, context: SudojoApiValue | null, hookName?: string): ResolvedSudojoApi;
+/**
+ * Resolve a hook's API connection: explicit options first, then the
+ * SudojoApiProvider.
+ * @throws Error when neither supplies networkClient and baseUrl
+ */
+export declare function useResolvedSudojoApi(options: SudojoApiOptions, hookName?: string): ResolvedSudojoApi;
+export { SudojoApiContext };
+//# sourceMappingURL=SudojoApiContext.d.ts.map

package/dist/context/SudojoApiContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SudojoApiContext.d.ts","sourceRoot":"","sources":["../../src/context/SudojoApiContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnC;AAED,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnC;AAED,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,QAAA,MAAM,gBAAgB,gDAA6C,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,YAAY,IAAI,cAAc,CAQ7C;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,IAAI,cAAc,GAAG,IAAI,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,GAAG,IAAI,EAC9B,QAAQ,SAAoB,GAC3B,iBAAiB,CAWnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,iBAAiB,CAGnB;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/context/SudojoApiContext.js

@@ -0,0 +1,52 @@
+/**
+ * SudojoApiContext
+ *
+ * Optional React context that supplies the API connection (network client,
+ * base URL, auth token) to sudojo_lib hooks. Apps wrap their tree with
+ * SudojoApiProvider once; hooks whose options carry `networkClient` /
+ * `baseUrl` / `token` may then omit them. Explicit options always win over
+ * the context, so existing callers keep working unchanged.
+ */
+import { createContext, useContext } from 'react';
+const SudojoApiContext = createContext(null);
+/**
+ * The API connection from the nearest SudojoApiProvider.
+ * @throws Error when there is no SudojoApiProvider above
+ */
+export function useSudojoApi() {
+    const value = useContext(SudojoApiContext);
+    if (!value) {
+        throw new Error('useSudojoApi: no SudojoApiProvider above this component. Wrap the app in <SudojoApiProvider> or pass networkClient/baseUrl explicitly.');
+    }
+    return value;
+}
+/** The API connection from the nearest SudojoApiProvider, or null. */
+export function useOptionalSudojoApi() {
+    return useContext(SudojoApiContext);
+}
+/**
+ * Merge explicit options over the provider's connection (pure; no hooks).
+ * `token` falls back to the provider only when the option is undefined, so an
+ * explicit null or '' means "no token".
+ * @throws Error when neither supplies networkClient and baseUrl
+ */
+export function resolveSudojoApi(options, context, hookName = 'sudojo_lib hook') {
+    const networkClient = options.networkClient ?? context?.networkClient;
+    const baseUrl = options.baseUrl ?? context?.baseUrl;
+    if (!networkClient || baseUrl === undefined) {
+        throw new Error(`${hookName}: networkClient and baseUrl are required. Pass them in the options or wrap the app in <SudojoApiProvider>.`);
+    }
+    const token = options.token !== undefined ? options.token : (context?.token ?? null);
+    return { networkClient, baseUrl, token: token ?? '' };
+}
+/**
+ * Resolve a hook's API connection: explicit options first, then the
+ * SudojoApiProvider.
+ * @throws Error when neither supplies networkClient and baseUrl
+ */
+export function useResolvedSudojoApi(options, hookName) {
+    const context = useContext(SudojoApiContext);
+    return resolveSudojoApi(options, context, hookName);
+}
+export { SudojoApiContext };
+//# sourceMappingURL=SudojoApiContext.js.map

package/dist/context/SudojoApiContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SudojoApiContext.js","sourceRoot":"","sources":["../../src/context/SudojoApiContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AA+BlD,MAAM,gBAAgB,GAAG,aAAa,CAAwB,IAAI,CAAC,CAAC;AAEpE;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,wIAAwI,CACzI,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,oBAAoB;IAClC,OAAO,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAyB,EACzB,OAA8B,EAC9B,QAAQ,GAAG,iBAAiB;IAE5B,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,EAAE,aAAa,CAAC;IACtE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,OAAO,CAAC;IACpD,IAAI,CAAC,aAAa,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,GAAG,QAAQ,4GAA4G,CACxH,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GACT,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC;IACzE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAyB,EACzB,QAAiB;IAEjB,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7C,OAAO,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["/**\n * SudojoApiContext\n *\n * Optional React context that supplies the API connection (network client,\n * base URL, auth token) to sudojo_lib hooks. Apps wrap their tree with\n * SudojoApiProvider once; hooks whose options carry `networkClient` /\n * `baseUrl` / `token` may then omit them. Explicit options always win over\n * the context, so existing callers keep working unchanged.\n */\n\nimport { createContext, useContext } from 'react';\nimport type { NetworkClient } from '@sudobility/types';\n\n/** The API connection the provider supplies. */\nexport interface SudojoApiValue {\n  /** Network client for API calls */\n  networkClient: NetworkClient;\n  /** Base URL for the Sudojo API */\n  baseUrl: string;\n  /** Firebase ID token, or null/undefined when signed out */\n  token?: string | null | undefined;\n}\n\n/** Optional API connection fields a hook's options may carry. */\nexport interface SudojoApiOptions {\n  /** Network client for API calls (default: SudojoApiProvider's) */\n  networkClient?: NetworkClient | undefined;\n  /** Base URL for the Sudojo API (default: SudojoApiProvider's) */\n  baseUrl?: string | undefined;\n  /** Access token (default: SudojoApiProvider's, else '') */\n  token?: string | null | undefined;\n}\n\n/** An API connection with every field resolved. */\nexport interface ResolvedSudojoApi {\n  networkClient: NetworkClient;\n  baseUrl: string;\n  /** The token, '' when there is none */\n  token: string;\n}\n\nconst SudojoApiContext = createContext<SudojoApiValue | null>(null);\n\n/**\n * The API connection from the nearest SudojoApiProvider.\n * @throws Error when there is no SudojoApiProvider above\n */\nexport function useSudojoApi(): SudojoApiValue {\n  const value = useContext(SudojoApiContext);\n  if (!value) {\n    throw new Error(\n      'useSudojoApi: no SudojoApiProvider above this component. Wrap the app in <SudojoApiProvider> or pass networkClient/baseUrl explicitly.'\n    );\n  }\n  return value;\n}\n\n/** The API connection from the nearest SudojoApiProvider, or null. */\nexport function useOptionalSudojoApi(): SudojoApiValue | null {\n  return useContext(SudojoApiContext);\n}\n\n/**\n * Merge explicit options over the provider's connection (pure; no hooks).\n * `token` falls back to the provider only when the option is undefined, so an\n * explicit null or '' means \"no token\".\n * @throws Error when neither supplies networkClient and baseUrl\n */\nexport function resolveSudojoApi(\n  options: SudojoApiOptions,\n  context: SudojoApiValue | null,\n  hookName = 'sudojo_lib hook'\n): ResolvedSudojoApi {\n  const networkClient = options.networkClient ?? context?.networkClient;\n  const baseUrl = options.baseUrl ?? context?.baseUrl;\n  if (!networkClient || baseUrl === undefined) {\n    throw new Error(\n      `${hookName}: networkClient and baseUrl are required. Pass them in the options or wrap the app in <SudojoApiProvider>.`\n    );\n  }\n  const token =\n    options.token !== undefined ? options.token : (context?.token ?? null);\n  return { networkClient, baseUrl, token: token ?? '' };\n}\n\n/**\n * Resolve a hook's API connection: explicit options first, then the\n * SudojoApiProvider.\n * @throws Error when neither supplies networkClient and baseUrl\n */\nexport function useResolvedSudojoApi(\n  options: SudojoApiOptions,\n  hookName?: string\n): ResolvedSudojoApi {\n  const context = useContext(SudojoApiContext);\n  return resolveSudojoApi(options, context, hookName);\n}\n\nexport { SudojoApiContext };\n"]}

package/dist/context/SudojoApiProvider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SudojoApiProvider
+ *
+ * Supplies the API connection (network client, base URL, token) to
+ * sudojo_lib hooks, so callers can omit those options. Optional: hooks still
+ * accept them explicitly, and explicit values win.
+ */
+import React from 'react';
+import type { NetworkClient } from '@sudobility/types';
+interface SudojoApiProviderProps {
+    /** Network client for API calls */
+    networkClient: NetworkClient;
+    /** Base URL for the Sudojo API */
+    baseUrl: string;
+    /** Firebase ID token, or null/undefined when signed out */
+    token?: string | null | undefined;
+    children: React.ReactNode;
+}
+export declare function SudojoApiProvider({ networkClient, baseUrl, token, children, }: SudojoApiProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=SudojoApiProvider.d.ts.map

package/dist/context/SudojoApiProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SudojoApiProvider.d.ts","sourceRoot":"","sources":["../../src/context/SudojoApiProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,UAAU,sBAAsB;IAC9B,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,EAChC,aAAa,EACb,OAAO,EACP,KAAK,EACL,QAAQ,GACT,EAAE,sBAAsB,2CAUxB"}

package/dist/context/SudojoApiProvider.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * SudojoApiProvider
+ *
+ * Supplies the API connection (network client, base URL, token) to
+ * sudojo_lib hooks, so callers can omit those options. Optional: hooks still
+ * accept them explicitly, and explicit values win.
+ */
+import { useMemo } from 'react';
+import { SudojoApiContext } from './SudojoApiContext';
+export function SudojoApiProvider({ networkClient, baseUrl, token, children, }) {
+    const value = useMemo(() => ({ networkClient, baseUrl, token }), [networkClient, baseUrl, token]);
+    return (_jsx(SudojoApiContext.Provider, { value: value, children: children }));
+}
+//# sourceMappingURL=SudojoApiProvider.js.map

package/dist/context/SudojoApiProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SudojoApiProvider.js","sourceRoot":"","sources":["../../src/context/SudojoApiProvider.tsx"],"names":[],"mappings":";AAAA;;;;;;GAMG;AAEH,OAAc,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAYtD,MAAM,UAAU,iBAAiB,CAAC,EAChC,aAAa,EACb,OAAO,EACP,KAAK,EACL,QAAQ,GACe;IACvB,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EACzC,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,CAChC,CAAC;IACF,OAAO,CACL,KAAC,gBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACpC,QAAQ,GACiB,CAC7B,CAAC;AACJ,CAAC","sourcesContent":["/**\n * SudojoApiProvider\n *\n * Supplies the API connection (network client, base URL, token) to\n * sudojo_lib hooks, so callers can omit those options. Optional: hooks still\n * accept them explicitly, and explicit values win.\n */\n\nimport React, { useMemo } from 'react';\nimport type { NetworkClient } from '@sudobility/types';\nimport { SudojoApiContext } from './SudojoApiContext';\n\ninterface SudojoApiProviderProps {\n  /** Network client for API calls */\n  networkClient: NetworkClient;\n  /** Base URL for the Sudojo API */\n  baseUrl: string;\n  /** Firebase ID token, or null/undefined when signed out */\n  token?: string | null | undefined;\n  children: React.ReactNode;\n}\n\nexport function SudojoApiProvider({\n  networkClient,\n  baseUrl,\n  token,\n  children,\n}: SudojoApiProviderProps) {\n  const value = useMemo(\n    () => ({ networkClient, baseUrl, token }),\n    [networkClient, baseUrl, token]\n  );\n  return (\n    <SudojoApiContext.Provider value={value}>\n      {children}\n    </SudojoApiContext.Provider>\n  );\n}\n"]}

package/dist/context/index.d.ts

@@ -1,3 +1,6 @@
 export { useEntitlementContext, EntitlementContext, } from './EntitlementContext';
 export { EntitlementProvider } from './EntitlementProvider';
+export type { SudojoApiValue, SudojoApiOptions, ResolvedSudojoApi, } from './SudojoApiContext';
+export { SudojoApiContext, useSudojoApi, useOptionalSudojoApi, resolveSudojoApi, useResolvedSudojoApi, } from './SudojoApiContext';
+export { SudojoApiProvider } from './SudojoApiProvider';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/context/index.js

@@ -1,3 +1,5 @@
 export { useEntitlementContext, EntitlementContext, } from './EntitlementContext';
 export { EntitlementProvider } from './EntitlementProvider';
+export { SudojoApiContext, useSudojoApi, useOptionalSudojoApi, resolveSudojoApi, useResolvedSudojoApi, } from './SudojoApiContext';
+export { SudojoApiProvider } from './SudojoApiProvider';
 //# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["export {\n  useEntitlementContext,\n  EntitlementContext,\n} from './EntitlementContext';\nexport { EntitlementProvider } from './EntitlementProvider';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM5D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["export {\n  useEntitlementContext,\n  EntitlementContext,\n} from './EntitlementContext';\nexport { EntitlementProvider } from './EntitlementProvider';\nexport type {\n  SudojoApiValue,\n  SudojoApiOptions,\n  ResolvedSudojoApi,\n} from './SudojoApiContext';\nexport {\n  SudojoApiContext,\n  useSudojoApi,\n  useOptionalSudojoApi,\n  resolveSudojoApi,\n  useResolvedSudojoApi,\n} from './SudojoApiContext';\nexport { SudojoApiProvider } from './SudojoApiProvider';\n"]}

package/dist/hooks/index.d.ts

@@ -31,7 +31,9 @@ export type { UseGamePlayOptions, UseGamePlayResult } from './useGamePlay';
 export { useContinueGame } from './useContinueGame';
 export type { UseContinueGameOptions, UseContinueGameResult, ContinueTarget, } from './useContinueGame';
 export { useBoardEntry } from './useBoardEntry';
-export type { UseBoardEntryOptions, UseBoardEntryReturn, ValidatedPuzzle, } from './useBoardEntry';
+export type { UseBoardEntryOptions, UseBoardEntryReturn, ValidatedPuzzle, BoardEntryPlayState, } from './useBoardEntry';
+export { useBoardScan } from './useBoardScan';
+export type { UseBoardScanOptions, UseBoardScanReturn } from './useBoardScan';
 export { useGameSession } from './useGameSession';
 export type { UseGameSessionOptions, GameSessionResult, GameFinishResult, } from './useGameSession';
 export { useLevelEnabled, useTechniqueEnabled } from './useEntitlement';
@@ -48,4 +50,25 @@ export { useRegeneratePracticeHints } from './usePractices';
 export type { UseRegeneratePracticeHintsOptions, UseRegeneratePracticeHintsResult, } from './usePractices';
 export { useProgressReporter } from './useProgressReporter';
 export type { UseProgressReporterOptions, ProgressUpdateCallback, } from './useProgressReporter';
+export { useCompletionTrigger } from './useCompletionTrigger';
+export { useStrategies } from './useStrategies';
+export type { UseStrategiesOptions, UseStrategiesResult, } from './useStrategies';
+export { usePracticeGame } from './usePracticeGame';
+export type { UsePracticeGameOptions, UsePracticeGameResult, } from './usePracticeGame';
+export { useIsRealUser, useIsSiteAdmin } from './useIsSiteAdmin';
+export type { UseIsSiteAdminOptions, UseIsSiteAdminResult, } from './useIsSiteAdmin';
+export { useTechniqueByPath } from './useTechniqueByPath';
+export type { UseTechniqueByPathOptions, UseTechniqueByPathResult, } from './useTechniqueByPath';
+export { useTechniqueExample, useTechniqueWalkthrough, } from './useTechniqueExample';
+export type { TechniqueExampleSourceKind, UseTechniqueExampleOptions, UseTechniqueExampleResult, } from './useTechniqueExample';
+export { usePuzzleProgress } from './usePuzzleProgress';
+export type { UsePuzzleProgressOptions, UsePuzzleProgressResult, } from './usePuzzleProgress';
+export { useDeleteAccount } from './useDeleteAccount';
+export type { DeleteAccountOutcome, DeleteAccountProviderTokens, UseDeleteAccountOptions, UseDeleteAccountResult, } from './useDeleteAccount';
+export { getResumeGame, useResumeGame } from './useResumeGame';
+export type { PuzzleSessionSource, ResumeGameSource, UseResumeGameOptions, UseResumeGameResult, } from './useResumeGame';
+export { usePuzzleSession } from './usePuzzleSession';
+export type { ActivePuzzle, PuzzleGameProps, SessionPuzzleInput, UsePuzzleSessionOptions, UsePuzzleSessionResult, } from './usePuzzleSession';
+export { useEnteredGameSession } from './useEnteredGameSession';
+export type { UseEnteredGameSessionOptions, UseEnteredGameSessionResult, } from './useEnteredGameSession';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/hooks/index.js

@@ -32,6 +32,8 @@ export { useGamePlay } from './useGamePlay';
 export { useContinueGame } from './useContinueGame';
 // Board entry hook
 export { useBoardEntry } from './useBoardEntry';
+// Board scan (OCR) hook
+export { useBoardScan } from './useBoardScan';
 // Game session hook
 export { useGameSession } from './useGameSession';
 // Entitlement access hooks
@@ -50,4 +52,24 @@ export { emitHintAction, reportHintStatus, onHintStatus, useHintActionListener,
 export { useRegeneratePracticeHints } from './usePractices';
 // Progress reporting (shared across web and RN SudokuGame)
 export { useProgressReporter } from './useProgressReporter';
+// Completion latch (shared across web, RN and extension game components)
+export { useCompletionTrigger } from './useCompletionTrigger';
+// Strategies
+export { useStrategies } from './useStrategies';
+// Practice game (random practice with auth/subscription states)
+export { usePracticeGame } from './usePracticeGame';
+// User status
+export { useIsRealUser, useIsSiteAdmin } from './useIsSiteAdmin';
+// Technique lookup and worked example
+export { useTechniqueByPath } from './useTechniqueByPath';
+export { useTechniqueExample, useTechniqueWalkthrough, } from './useTechniqueExample';
+// Puzzle progress (completed puzzles, streak, stats)
+export { usePuzzleProgress } from './usePuzzleProgress';
+// Account deletion
+export { useDeleteAccount } from './useDeleteAccount';
+// Play screen session orchestration (resume, save, server session, completion)
+export { getResumeGame, useResumeGame } from './useResumeGame';
+export { usePuzzleSession } from './usePuzzleSession';
+// Entered puzzle save/resume (after useBoardEntry validates)
+export { useEnteredGameSession } from './useEnteredGameSession';
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQlD,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQ9D,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQ7D,sBAAsB;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,wCAAwC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,wDAAwD;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMvE,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,YAAY;AACZ,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,2CAA2C;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,2DAA2D;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,mBAAmB;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOhD,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOlD,2BAA2B;AAC3B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAExE,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,2BAA2B;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,4DAA4D;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,gEAAgE;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,kEAAkE;AAClE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,4BAA4B;AAC5B,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAM5D,2DAA2D;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["/**\n * Hook exports for Sudojo library\n */\n\n// Levels hooks\nexport { useLevel, useLevels } from './useLevels';\nexport type {\n  UseLevelOptions,\n  UseLevelResult,\n  UseLevelsOptions,\n  UseLevelsResult,\n} from './useLevels';\n\n// Techniques hooks\nexport { useTechnique, useTechniques } from './useTechniques';\nexport type {\n  UseTechniqueOptions,\n  UseTechniqueResult,\n  UseTechniquesOptions,\n  UseTechniquesResult,\n} from './useTechniques';\n\n// Communities hooks\nexport { useCommunities } from './useCommunities';\nexport type {\n  UseCommunitiesOptions,\n  UseCommunitiesResult,\n} from './useCommunities';\n\n// Learning hooks\nexport { useLearning, useLearningItem } from './useLearning';\nexport type {\n  UseLearningItemOptions,\n  UseLearningItemResult,\n  UseLearningOptions,\n  UseLearningResult,\n} from './useLearning';\n\n// Game hooks (legacy)\nexport { useGame } from './useGame';\nexport type { UseGameOptions, UseGameResult } from './useGame';\n\n// Teaching hooks\nexport { useGameTeaching } from './useGameTeaching';\nexport type {\n  UseGameTeachingOptions,\n  UseGameTeachingResult,\n} from './useGameTeaching';\n\n// Sudoku hooks (ported from renderable)\nexport { useSudoku } from './useSudoku';\nexport type { UseSudokuOptions, UseSudokuResult } from './useSudoku';\n\n// Game fetching hooks (with auth/subscription handling)\nexport { useLevelGame } from './useLevelGame';\nexport type {\n  UseLevelGameOptions,\n  UseLevelGameResult,\n  GameFetchStatus,\n} from './useLevelGame';\n\nexport { useDailyGame } from './useDailyGame';\nexport type { UseDailyGameOptions, UseDailyGameResult } from './useDailyGame';\n\n// Game timer hook\nexport { useGameTimer } from './useGameTimer';\nexport type { UseGameTimerOptions, UseGameTimerResult } from './useGameTimer';\n\n// Game persistence hooks\nexport { useGamePersistence, useAutoSave } from './useGamePersistence';\nexport type {\n  UseGamePersistenceOptions,\n  UseGamePersistenceResult,\n} from './useGamePersistence';\n\n// Local storage hook\nexport { useLocalStorage } from './useLocalStorage';\n\n// Hint hook\nexport { useHint } from './useHint';\nexport type {\n  UseHintOptions,\n  UseHintResult,\n  HintBoardData,\n  HintReceivedData,\n  HintAccessError,\n} from './useHint';\n\n// Game play hook (current game management)\nexport { useGamePlay } from './useGamePlay';\nexport type { UseGamePlayOptions, UseGamePlayResult } from './useGamePlay';\n\n// Continue game hook (shared \"Continue Last Sudoku\" logic)\nexport { useContinueGame } from './useContinueGame';\nexport type {\n  UseContinueGameOptions,\n  UseContinueGameResult,\n  ContinueTarget,\n} from './useContinueGame';\n\n// Board entry hook\nexport { useBoardEntry } from './useBoardEntry';\nexport type {\n  UseBoardEntryOptions,\n  UseBoardEntryReturn,\n  ValidatedPuzzle,\n} from './useBoardEntry';\n\n// Game session hook\nexport { useGameSession } from './useGameSession';\nexport type {\n  UseGameSessionOptions,\n  GameSessionResult,\n  GameFinishResult,\n} from './useGameSession';\n\n// Entitlement access hooks\nexport { useLevelEnabled, useTechniqueEnabled } from './useEntitlement';\n\n// Display level hook\nexport { useDisplayLevel } from './useDisplayLevel';\nexport type { UseDisplayLevelResult } from './useDisplayLevel';\n\n// Puzzle distribution hook\nexport { usePuzzleDistribution } from './usePuzzleDistribution';\n\n// Hint step tracker (shared across web and RN game screens)\nexport { useHintStepTracker } from './useHintStepTracker';\nexport type { UseHintStepTrackerResult } from './useHintStepTracker';\n\n// Auto-hint orchestration (shared across web and RN SudokuGame)\nexport { useAutoHint } from './useAutoHint';\nexport type { UseAutoHintOptions } from './useAutoHint';\n\n// Hint action events (external control of hint UI via deep links)\nexport {\n  emitHintAction,\n  reportHintStatus,\n  onHintStatus,\n  useHintActionListener,\n} from './useHintAction';\nexport type { HintActionStatus } from './useHintAction';\n\n// Admin practice operations\nexport { useRegeneratePracticeHints } from './usePractices';\nexport type {\n  UseRegeneratePracticeHintsOptions,\n  UseRegeneratePracticeHintsResult,\n} from './usePractices';\n\n// Progress reporting (shared across web and RN SudokuGame)\nexport { useProgressReporter } from './useProgressReporter';\nexport type {\n  UseProgressReporterOptions,\n  ProgressUpdateCallback,\n} from './useProgressReporter';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hook exports for Sudojo library\n */\n\n// Levels hooks\nexport { useLevel, useLevels } from './useLevels';\nexport type {\n  UseLevelOptions,\n  UseLevelResult,\n  UseLevelsOptions,\n  UseLevelsResult,\n} from './useLevels';\n\n// Techniques hooks\nexport { useTechnique, useTechniques } from './useTechniques';\nexport type {\n  UseTechniqueOptions,\n  UseTechniqueResult,\n  UseTechniquesOptions,\n  UseTechniquesResult,\n} from './useTechniques';\n\n// Communities hooks\nexport { useCommunities } from './useCommunities';\nexport type {\n  UseCommunitiesOptions,\n  UseCommunitiesResult,\n} from './useCommunities';\n\n// Learning hooks\nexport { useLearning, useLearningItem } from './useLearning';\nexport type {\n  UseLearningItemOptions,\n  UseLearningItemResult,\n  UseLearningOptions,\n  UseLearningResult,\n} from './useLearning';\n\n// Game hooks (legacy)\nexport { useGame } from './useGame';\nexport type { UseGameOptions, UseGameResult } from './useGame';\n\n// Teaching hooks\nexport { useGameTeaching } from './useGameTeaching';\nexport type {\n  UseGameTeachingOptions,\n  UseGameTeachingResult,\n} from './useGameTeaching';\n\n// Sudoku hooks (ported from renderable)\nexport { useSudoku } from './useSudoku';\nexport type { UseSudokuOptions, UseSudokuResult } from './useSudoku';\n\n// Game fetching hooks (with auth/subscription handling)\nexport { useLevelGame } from './useLevelGame';\nexport type {\n  UseLevelGameOptions,\n  UseLevelGameResult,\n  GameFetchStatus,\n} from './useLevelGame';\n\nexport { useDailyGame } from './useDailyGame';\nexport type { UseDailyGameOptions, UseDailyGameResult } from './useDailyGame';\n\n// Game timer hook\nexport { useGameTimer } from './useGameTimer';\nexport type { UseGameTimerOptions, UseGameTimerResult } from './useGameTimer';\n\n// Game persistence hooks\nexport { useGamePersistence, useAutoSave } from './useGamePersistence';\nexport type {\n  UseGamePersistenceOptions,\n  UseGamePersistenceResult,\n} from './useGamePersistence';\n\n// Local storage hook\nexport { useLocalStorage } from './useLocalStorage';\n\n// Hint hook\nexport { useHint } from './useHint';\nexport type {\n  UseHintOptions,\n  UseHintResult,\n  HintBoardData,\n  HintReceivedData,\n  HintAccessError,\n} from './useHint';\n\n// Game play hook (current game management)\nexport { useGamePlay } from './useGamePlay';\nexport type { UseGamePlayOptions, UseGamePlayResult } from './useGamePlay';\n\n// Continue game hook (shared \"Continue Last Sudoku\" logic)\nexport { useContinueGame } from './useContinueGame';\nexport type {\n  UseContinueGameOptions,\n  UseContinueGameResult,\n  ContinueTarget,\n} from './useContinueGame';\n\n// Board entry hook\nexport { useBoardEntry } from './useBoardEntry';\nexport type {\n  UseBoardEntryOptions,\n  UseBoardEntryReturn,\n  ValidatedPuzzle,\n  BoardEntryPlayState,\n} from './useBoardEntry';\n\n// Board scan (OCR) hook\nexport { useBoardScan } from './useBoardScan';\nexport type { UseBoardScanOptions, UseBoardScanReturn } from './useBoardScan';\n\n// Game session hook\nexport { useGameSession } from './useGameSession';\nexport type {\n  UseGameSessionOptions,\n  GameSessionResult,\n  GameFinishResult,\n} from './useGameSession';\n\n// Entitlement access hooks\nexport { useLevelEnabled, useTechniqueEnabled } from './useEntitlement';\n\n// Display level hook\nexport { useDisplayLevel } from './useDisplayLevel';\nexport type { UseDisplayLevelResult } from './useDisplayLevel';\n\n// Puzzle distribution hook\nexport { usePuzzleDistribution } from './usePuzzleDistribution';\n\n// Hint step tracker (shared across web and RN game screens)\nexport { useHintStepTracker } from './useHintStepTracker';\nexport type { UseHintStepTrackerResult } from './useHintStepTracker';\n\n// Auto-hint orchestration (shared across web and RN SudokuGame)\nexport { useAutoHint } from './useAutoHint';\nexport type { UseAutoHintOptions } from './useAutoHint';\n\n// Hint action events (external control of hint UI via deep links)\nexport {\n  emitHintAction,\n  reportHintStatus,\n  onHintStatus,\n  useHintActionListener,\n} from './useHintAction';\nexport type { HintActionStatus } from './useHintAction';\n\n// Admin practice operations\nexport { useRegeneratePracticeHints } from './usePractices';\nexport type {\n  UseRegeneratePracticeHintsOptions,\n  UseRegeneratePracticeHintsResult,\n} from './usePractices';\n\n// Progress reporting (shared across web and RN SudokuGame)\nexport { useProgressReporter } from './useProgressReporter';\nexport type {\n  UseProgressReporterOptions,\n  ProgressUpdateCallback,\n} from './useProgressReporter';\n\n// Completion latch (shared across web, RN and extension game components)\nexport { useCompletionTrigger } from './useCompletionTrigger';\n\n// Strategies\nexport { useStrategies } from './useStrategies';\nexport type {\n  UseStrategiesOptions,\n  UseStrategiesResult,\n} from './useStrategies';\n\n// Practice game (random practice with auth/subscription states)\nexport { usePracticeGame } from './usePracticeGame';\nexport type {\n  UsePracticeGameOptions,\n  UsePracticeGameResult,\n} from './usePracticeGame';\n\n// User status\nexport { useIsRealUser, useIsSiteAdmin } from './useIsSiteAdmin';\nexport type {\n  UseIsSiteAdminOptions,\n  UseIsSiteAdminResult,\n} from './useIsSiteAdmin';\n\n// Technique lookup and worked example\nexport { useTechniqueByPath } from './useTechniqueByPath';\nexport type {\n  UseTechniqueByPathOptions,\n  UseTechniqueByPathResult,\n} from './useTechniqueByPath';\nexport {\n  useTechniqueExample,\n  useTechniqueWalkthrough,\n} from './useTechniqueExample';\nexport type {\n  TechniqueExampleSourceKind,\n  UseTechniqueExampleOptions,\n  UseTechniqueExampleResult,\n} from './useTechniqueExample';\n\n// Puzzle progress (completed puzzles, streak, stats)\nexport { usePuzzleProgress } from './usePuzzleProgress';\nexport type {\n  UsePuzzleProgressOptions,\n  UsePuzzleProgressResult,\n} from './usePuzzleProgress';\n\n// Account deletion\nexport { useDeleteAccount } from './useDeleteAccount';\nexport type {\n  DeleteAccountOutcome,\n  DeleteAccountProviderTokens,\n  UseDeleteAccountOptions,\n  UseDeleteAccountResult,\n} from './useDeleteAccount';\n\n// Play screen session orchestration (resume, save, server session, completion)\nexport { getResumeGame, useResumeGame } from './useResumeGame';\nexport type {\n  PuzzleSessionSource,\n  ResumeGameSource,\n  UseResumeGameOptions,\n  UseResumeGameResult,\n} from './useResumeGame';\nexport { usePuzzleSession } from './usePuzzleSession';\nexport type {\n  ActivePuzzle,\n  PuzzleGameProps,\n  SessionPuzzleInput,\n  UsePuzzleSessionOptions,\n  UsePuzzleSessionResult,\n} from './usePuzzleSession';\n\n// Entered puzzle save/resume (after useBoardEntry validates)\nexport { useEnteredGameSession } from './useEnteredGameSession';\nexport type {\n  UseEnteredGameSessionOptions,\n  UseEnteredGameSessionResult,\n} from './useEnteredGameSession';\n"]}

package/dist/hooks/useBoardEntry.d.ts

@@ -4,6 +4,7 @@
  */
 import type { SudokuCell } from '../types';
 import type { NetworkClient } from '@sudobility/types';
+import { type ScannedBoard } from '../utils/scannedBoard';
 export interface ValidatedPuzzle {
     puzzle: string;
     solution: string;
@@ -13,9 +14,26 @@ export interface ValidatedPuzzle {
     difficultyScore?: number | undefined;
 }
 export interface UseBoardEntryOptions {
-    networkClient: NetworkClient;
-    baseUrl: string;
-    token: string;
+    /** Network client for API calls (default: SudojoApiProvider) */
+    networkClient?: NetworkClient | undefined;
+    /** Base URL for the Sudojo API (default: SudojoApiProvider) */
+    baseUrl?: string | undefined;
+    /** Access token (default: SudojoApiProvider) */
+    token?: string | null | undefined;
+}
+/**
+ * What the game should apply once the entered puzzle is validated: the
+ * scanned player digits and/or the entry pencilmarks. Pass the fields to the
+ * game as initialInput / initialPencilmarks / initialAutoPencilmarks (or to
+ * useSudoku's applyHintData).
+ */
+export interface BoardEntryPlayState {
+    /** 81-char player input ('0' = none). '0'.repeat(81) when only pencilmarks exist */
+    input?: string;
+    /** 81 comma-separated pencilmark entries */
+    pencilmarks?: string;
+    /** Whether the pencilmarks were auto-filled */
+    autopencil?: boolean;
 }
 export interface UseBoardEntryReturn {
     /** 81 cells with given values only */
@@ -42,8 +60,50 @@ export interface UseBoardEntryReturn {
     reset: () => void;
     /** Number of clues entered */
     clueCount: number;
-    /** Set cells from an 81-character puzzle string */
+    /** Set cells from an 81-character puzzle string (clears pencilmarks and scanned input) */
     setCellsFromPuzzle: (puzzle: string) => void;
+    /** Per-cell entry pencilmarks (81 sorted digit arrays; [] = none) */
+    pencilmarks: number[][];
+    /** Whether the pencilmarks were auto-filled (from a scan) */
+    autopencil: boolean;
+    /** Whether any cell has pencilmarks */
+    hasPencilmarks: boolean;
+    /** Pencilmarks as 81 comma-separated entries (e.g. "12,,9,...") */
+    pencilmarksString: string;
+    /** Toggle a pencilmark digit on the selected cell (ignored on givens) */
+    togglePencilmark: (digit: number) => void;
+    /** `cells` with the entry pencilmarks merged in, for display */
+    displayCells: SudokuCell[];
+    /** Whether digit input goes to pencilmarks instead of givens */
+    isPencilMode: boolean;
+    /** Toggle pencil mode */
+    togglePencilMode: () => void;
+    /** Set pencil mode */
+    setPencilMode: (on: boolean) => void;
+    /**
+     * Route a digit: in pencil mode toggle a pencilmark, otherwise set a given
+     * (web/RN entry keypad behavior).
+     */
+    enterDigit: (value: number) => void;
+    /**
+     * Set a given at the selected cell, or erase it when the cell already holds
+     * that digit (extension keypad behavior).
+     */
+    toggleGiven: (value: number) => void;
+    /** Whether Validate may run (enough clues and not already validating) */
+    canValidate: boolean;
+    /**
+     * Load a scanned board: givens from `original`, pencilmarks and autopencil
+     * from the scan, and the player's digits as `scannedInput`.
+     */
+    applyScan: (scanned: ScannedBoard) => void;
+    /** The scanned player digits (81 chars), or null when the scan had none */
+    scannedInput: string | null;
+    /**
+     * What the game should apply once validated (scanned input and/or entry
+     * pencilmarks), or undefined when there is nothing to restore.
+     */
+    initialPlayState: BoardEntryPlayState | undefined;
 }
-export declare function useBoardEntry({ networkClient, baseUrl, token, }: UseBoardEntryOptions): UseBoardEntryReturn;
+export declare function useBoardEntry(options?: UseBoardEntryOptions): UseBoardEntryReturn;
 //# sourceMappingURL=useBoardEntry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useBoardEntry.d.ts","sourceRoot":"","sources":["../../src/hooks/useBoardEntry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,oCAAoC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wCAAwC;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,mCAAmC;IACnC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gEAAgE;IAChE,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,6BAA6B;IAC7B,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAoED,wBAAgB,aAAa,CAAC,EAC5B,aAAa,EACb,OAAO,EACP,KAAK,GACN,EAAE,oBAAoB,GAAG,mBAAmB,CA2L5C"}
+{"version":3,"file":"useBoardEntry.d.ts","sourceRoot":"","sources":["../../src/hooks/useBoardEntry.ts"],"names":[],"mappings":"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"}