@sudobility/sudojo_lib 0.0.201 → 0.0.203

package/dist/admin/examples.js

@@ -0,0 +1,104 @@
+/**
+ * Pure rules for the technique-example creator: which techniques still need
+ * examples, where to search for boards, and the example + linked practice
+ * requests built from a find.
+ *
+ * Ported from `sudojo_app/src/utils/admin/ExampleCreator.ts` and the
+ * constants of `sudojo_app/src/pages/AdminPage.tsx`.
+ */
+import { ALL_TECHNIQUE_IDS, formatTechniqueBitmask, MAX_LEVEL, MIN_LEVEL, techniqueIdsToBitmask, } from '@sudobility/sudojo_types';
+import { adjustPracticeSolution, mergeBoardWithUserInput, } from './boardStrings';
+/** Examples wanted per technique. */
+export const ADMIN_EXAMPLE_TARGET_PER_TECHNIQUE = 1;
+/** Every technique id, easiest (lowest id) first: the creator's work order. */
+export const ADMIN_TECHNIQUE_ORDER = [
+    ...ALL_TECHNIQUE_IDS,
+].sort((a, b) => a - b);
+/** Boards fetched per technique by bit. */
+export const BOARDS_WITH_TECHNIQUE_LIMIT = 50;
+/** Boards fetched per level in the level-based search. */
+export const BOARDS_PER_LEVEL_LIMIT = 100;
+/**
+ * Normalize an API counts map (string keys, e.g. `/examples/counts`) to
+ * numeric technique-id keys. null/undefined → {}.
+ */
+export function normalizeTechniqueCounts(data) {
+    const result = {};
+    if (!data)
+        return result;
+    for (const [key, value] of Object.entries(data)) {
+        const id = parseInt(key, 10);
+        if (!Number.isNaN(id))
+            result[id] = value;
+    }
+    return result;
+}
+/** Count for a technique (0 when absent). */
+export function countForTechnique(counts, techniqueId) {
+    return counts[techniqueId] || 0;
+}
+/** True when the technique already has `target` examples. */
+export function hasReachedTarget(counts, techniqueId, target) {
+    return countForTechnique(counts, techniqueId) >= target;
+}
+/** Techniques in `order` that still need examples. */
+export function techniquesNeedingExamples(order, counts, target) {
+    return order.filter(id => !hasReachedTarget(counts, id, target));
+}
+/** Sum of all counts. */
+export function totalTechniqueCount(counts) {
+    return Object.values(counts).reduce((sum, c) => sum + c, 0);
+}
+/** technique id → level (null when the technique has no level). */
+export function buildTechniqueLevelMap(techniques) {
+    const map = new Map();
+    for (const tech of techniques ?? [])
+        map.set(tech.technique, tech.level);
+    return map;
+}
+/**
+ * Levels to search, in order, for a technique at `techniqueLevel`: one below,
+ * its own, then two above (a technique often first appears on harder
+ * boards). Clamped to MIN_LEVEL..MAX_LEVEL.
+ */
+export function levelsToSearchForTechnique(techniqueLevel) {
+    return [
+        techniqueLevel - 1,
+        techniqueLevel,
+        techniqueLevel + 1,
+        techniqueLevel + 2,
+    ].filter(level => level >= MIN_LEVEL && level <= MAX_LEVEL);
+}
+/**
+ * Build the example and practice requests for a find on `board`.
+ *
+ * `found.userInput` holds only the solver's cells (never the givens), so the
+ * stored board is `mergeBoardWithUserInput(board.board, found.userInput)`.
+ * The practice's solution is blanked ('0') wherever that board is filled.
+ */
+export function buildExampleSaveRequests(board, found) {
+    const mergedBoard = mergeBoardWithUserInput(board.board, found.userInput);
+    const hintData = JSON.stringify(found.hintData);
+    const pencilmarks = found.pencilmarks || undefined;
+    return {
+        mergedBoard,
+        example: {
+            board: mergedBoard,
+            pencilmarks,
+            solution: board.solution,
+            techniques_bitfield: formatTechniqueBitmask(techniqueIdsToBitmask([found.techniqueId])),
+            primary_technique: found.techniqueId,
+            hint_data: hintData,
+            source_board_uuid: board.uuid,
+        },
+        practice: {
+            technique: found.techniqueId,
+            board: mergedBoard,
+            pencilmarks,
+            solution: adjustPracticeSolution(mergedBoard, board.solution),
+            hint_data: hintData,
+            source_example_uuid: undefined,
+        },
+    };
+}
+//# sourceMappingURL=examples.js.map

package/dist/admin/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../src/admin/examples.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure rules for the technique-example creator: which techniques still need\n * examples, where to search for boards, and the example + linked practice\n * requests built from a find.\n *\n * Ported from `sudojo_app/src/utils/admin/ExampleCreator.ts` and the\n * constants of `sudojo_app/src/pages/AdminPage.tsx`.\n */\n\nimport {\n  ALL_TECHNIQUE_IDS,\n  type Board,\n  formatTechniqueBitmask,\n  MAX_LEVEL,\n  MIN_LEVEL,\n  type Technique,\n  type TechniqueExampleCreateRequest,\n  type TechniqueId,\n  techniqueIdsToBitmask,\n  type TechniquePracticeCreateRequest,\n} from '@sudobility/sudojo_types';\nimport {\n  adjustPracticeSolution,\n  mergeBoardWithUserInput,\n} from './boardStrings';\nimport type { TechniqueExampleFound } from './extraction';\n\n/** Examples wanted per technique. */\nexport const ADMIN_EXAMPLE_TARGET_PER_TECHNIQUE = 1;\n\n/** Every technique id, easiest (lowest id) first: the creator's work order. */\nexport const ADMIN_TECHNIQUE_ORDER: readonly TechniqueId[] = [\n  ...ALL_TECHNIQUE_IDS,\n].sort((a, b) => a - b);\n\n/** Boards fetched per technique by bit. */\nexport const BOARDS_WITH_TECHNIQUE_LIMIT = 50;\n\n/** Boards fetched per level in the level-based search. */\nexport const BOARDS_PER_LEVEL_LIMIT = 100;\n\n/** Example counts keyed by technique id. */\nexport type TechniqueCounts = Readonly<Record<number, number>>;\n\n/**\n * Normalize an API counts map (string keys, e.g. `/examples/counts`) to\n * numeric technique-id keys. null/undefined → {}.\n */\nexport function normalizeTechniqueCounts(\n  data:\n    | Readonly<Record<string, number>>\n    | Readonly<Record<number, number>>\n    | null\n    | undefined\n): Record<number, number> {\n  const result: Record<number, number> = {};\n  if (!data) return result;\n  for (const [key, value] of Object.entries(data)) {\n    const id = parseInt(key, 10);\n    if (!Number.isNaN(id)) result[id] = value;\n  }\n  return result;\n}\n\n/** Count for a technique (0 when absent). */\nexport function countForTechnique(\n  counts: TechniqueCounts,\n  techniqueId: number\n): number {\n  return counts[techniqueId] || 0;\n}\n\n/** True when the technique already has `target` examples. */\nexport function hasReachedTarget(\n  counts: TechniqueCounts,\n  techniqueId: number,\n  target: number\n): boolean {\n  return countForTechnique(counts, techniqueId) >= target;\n}\n\n/** Techniques in `order` that still need examples. */\nexport function techniquesNeedingExamples(\n  order: readonly TechniqueId[],\n  counts: TechniqueCounts,\n  target: number\n): TechniqueId[] {\n  return order.filter(id => !hasReachedTarget(counts, id, target));\n}\n\n/** Sum of all counts. */\nexport function totalTechniqueCount(counts: TechniqueCounts): number {\n  return Object.values(counts).reduce((sum, c) => sum + c, 0);\n}\n\n/** technique id → level (null when the technique has no level). */\nexport function buildTechniqueLevelMap(\n  techniques: readonly Technique[] | null | undefined\n): Map<number, number | null> {\n  const map = new Map<number, number | null>();\n  for (const tech of techniques ?? []) map.set(tech.technique, tech.level);\n  return map;\n}\n\n/**\n * Levels to search, in order, for a technique at `techniqueLevel`: one below,\n * its own, then two above (a technique often first appears on harder\n * boards). Clamped to MIN_LEVEL..MAX_LEVEL.\n */\nexport function levelsToSearchForTechnique(techniqueLevel: number): number[] {\n  return [\n    techniqueLevel - 1,\n    techniqueLevel,\n    techniqueLevel + 1,\n    techniqueLevel + 2,\n  ].filter(level => level >= MIN_LEVEL && level <= MAX_LEVEL);\n}\n\n/** Requests to save a find: the example, then (after it) the linked practice. */\nexport interface ExampleSaveRequests {\n  /** Source givens + the cells the solver filled before reaching the technique */\n  mergedBoard: string;\n  example: TechniqueExampleCreateRequest;\n  /** Practice request without `source_example_uuid` (set it from the example) */\n  practice: TechniquePracticeCreateRequest;\n}\n\n/**\n * Build the example and practice requests for a find on `board`.\n *\n * `found.userInput` holds only the solver's cells (never the givens), so the\n * stored board is `mergeBoardWithUserInput(board.board, found.userInput)`.\n * The practice's solution is blanked ('0') wherever that board is filled.\n */\nexport function buildExampleSaveRequests(\n  board: Pick<Board, 'uuid' | 'board' | 'solution'>,\n  found: TechniqueExampleFound\n): ExampleSaveRequests {\n  const mergedBoard = mergeBoardWithUserInput(board.board, found.userInput);\n  const hintData = JSON.stringify(found.hintData);\n  const pencilmarks = found.pencilmarks || undefined;\n  return {\n    mergedBoard,\n    example: {\n      board: mergedBoard,\n      pencilmarks,\n      solution: board.solution,\n      techniques_bitfield: formatTechniqueBitmask(\n        techniqueIdsToBitmask([found.techniqueId])\n      ),\n      primary_technique: found.techniqueId,\n      hint_data: hintData,\n      source_board_uuid: board.uuid,\n    },\n    practice: {\n      technique: found.techniqueId,\n      board: mergedBoard,\n      pencilmarks,\n      solution: adjustPracticeSolution(mergedBoard, board.solution),\n      hint_data: hintData,\n      source_example_uuid: undefined,\n    },\n  };\n}\n"]}

package/dist/admin/extraction.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Single-board technique extraction: walk one board to completion with
+ * repeated /solve calls, accumulating the techniques bitmask and max level,
+ * or stop early when a wanted technique shows up.
+ *
+ * The step logic is pure; `extractBoardTechniques` is the loop and takes the
+ * solve call as a function, so it works with any transport (the hooks pass a
+ * `useSolverSolveMutation` call).
+ *
+ * Ported from `sudojo_app/src/utils/admin/SingleBoardExtractor.ts`.
+ */
+import { type BaseResponse, type SolveData, type SolveOptions, type SolverBoard, type SolverHints, type TechniqueId } from '@sudobility/sudojo_types';
+/** Give up on a board after this many /solve steps. */
+export declare const MAX_EXTRACTION_ITERATIONS = 200;
+/** Techniques and level found by walking a board to the end. */
+export interface BoardExtractionResult {
+    /** Exact techniques bitmask (bit N = technique N); can exceed 2^53 */
+    readonly techniques: bigint;
+    readonly level: number;
+}
+/** Extraction stopped with an error (e.g. invalid pencilmarks). */
+export interface BoardExtractionError {
+    readonly error: string;
+}
+/** The wanted technique was reached; the board state where it applies. */
+export interface TechniqueExampleFound {
+    readonly type: 'found';
+    /** Solver-filled cells only (no givens); merge with the original board. */
+    readonly userInput: string;
+    readonly pencilmarks: string;
+    readonly techniqueId: TechniqueId;
+    /** Full `SolverHints` for the step, all steps included */
+    readonly hintData: SolverHints;
+}
+export type BoardExtractionOutcome = BoardExtractionResult | TechniqueExampleFound | BoardExtractionError;
+/** Board state carried between /solve steps. */
+export interface ExtractionState {
+    readonly userInput: string;
+    readonly pencilmarks: string;
+    readonly autoPencilmarks: boolean;
+    readonly techniquesBitfield: bigint;
+    readonly maxLevel: number;
+}
+/** One step's outcome: a new state, a find, an error, or null (no progress). */
+export type ExtractionStepOutcome = ExtractionState | TechniqueExampleFound | BoardExtractionError | null;
+/** Type guards for the outcome unions. */
+export declare const isExtractionError: (value: BoardExtractionOutcome | ExtractionStepOutcome) => value is BoardExtractionError;
+export declare const isTechniqueFound: (value: BoardExtractionOutcome | ExtractionStepOutcome) => value is TechniqueExampleFound;
+/** Initial state: empty user grid, no pencilmarks, auto-pencilmarks off. */
+export declare function createInitialExtractionState(): ExtractionState;
+/**
+ * Solve request for the current state. Pencilmarks (and the auto-pencilmark
+ * flag) are only sent when the state has pencilmark content; `techniques`
+ * filters the solver to the wanted technique.
+ */
+export declare function buildExtractionSolveOptions(original: string, state: ExtractionState, desiredTechnique?: TechniqueId): SolveOptions;
+/**
+ * Next state from a hint, or null when the solver's board did not change
+ * (no progress possible). Technique 0 (auto-pencilmark / correction hints)
+ * adds no bit; level 0 does not lower the max.
+ */
+export declare function computeNextExtractionState(state: ExtractionState, hints: SolverHints, boardData: SolverBoard | undefined | null): ExtractionState | null;
+/** Final result of a state. */
+export declare function extractionStateToResult(state: ExtractionState): BoardExtractionResult;
+/**
+ * Interpret one /solve response:
+ * - no hint steps → null (no progress)
+ * - an "Invalid Pencilmarks" step → error
+ * - the wanted technique → `found` with the state *before* the step
+ * - otherwise → the next state (null when the board did not change)
+ */
+export declare function interpretSolveResponse(response: BaseResponse<SolveData>, state: ExtractionState, desiredTechnique?: TechniqueId): ExtractionStepOutcome;
+/**
+ * A thrown /solve call: messages containing "Invalid" or "400" are errors,
+ * anything else (network, timeout) counts as no progress.
+ */
+export declare function interpretSolveError(err: unknown): BoardExtractionError | null;
+/** Performs one /solve call. */
+export type SolveFn = (options: SolveOptions) => Promise<BaseResponse<SolveData>>;
+/**
+ * Walk `original` with /solve until it is filled or stuck. With
+ * `desiredTechnique`, the solver is filtered to it and the first matching
+ * hint returns `found`. Returns an error after
+ * {@link MAX_EXTRACTION_ITERATIONS} steps.
+ */
+export declare function extractBoardTechniques(solve: SolveFn, original: string, desiredTechnique?: TechniqueId): Promise<BoardExtractionOutcome>;
+//# sourceMappingURL=extraction.d.ts.map

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

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

package/dist/admin/extraction.js

@@ -0,0 +1,141 @@
+/**
+ * Single-board technique extraction: walk one board to completion with
+ * repeated /solve calls, accumulating the techniques bitmask and max level,
+ * or stop early when a wanted technique shows up.
+ *
+ * The step logic is pure; `extractBoardTechniques` is the loop and takes the
+ * solve call as a function, so it works with any transport (the hooks pass a
+ * `useSolverSolveMutation` call).
+ *
+ * Ported from `sudojo_app/src/utils/admin/SingleBoardExtractor.ts`.
+ */
+import { EMPTY_BOARD, hasPencilmarkContent, techniqueIdsToBitmask, } from '@sudobility/sudojo_types';
+import { errorMessage, hasInvalidPencilmarksStep, isPuzzleFilled, } from './boardStrings';
+/** Give up on a board after this many /solve steps. */
+export const MAX_EXTRACTION_ITERATIONS = 200;
+/** Type guards for the outcome unions. */
+export const isExtractionError = (value) => value !== null && 'error' in value;
+export const isTechniqueFound = (value) => value !== null && 'type' in value && value.type === 'found';
+/** Initial state: empty user grid, no pencilmarks, auto-pencilmarks off. */
+export function createInitialExtractionState() {
+    return {
+        userInput: EMPTY_BOARD,
+        pencilmarks: '',
+        autoPencilmarks: false,
+        techniquesBitfield: 0n,
+        maxLevel: 0,
+    };
+}
+/**
+ * Solve request for the current state. Pencilmarks (and the auto-pencilmark
+ * flag) are only sent when the state has pencilmark content; `techniques`
+ * filters the solver to the wanted technique.
+ */
+export function buildExtractionSolveOptions(original, state, desiredTechnique) {
+    const hasPencilmarks = state.pencilmarks !== '' && hasPencilmarkContent(state.pencilmarks);
+    const options = {
+        original,
+        user: state.userInput,
+        autoPencilmarks: hasPencilmarks ? state.autoPencilmarks : false,
+    };
+    if (hasPencilmarks)
+        options.pencilmarks = state.pencilmarks;
+    if (desiredTechnique !== undefined) {
+        options.techniques = desiredTechnique.toString();
+    }
+    return options;
+}
+/**
+ * Next state from a hint, or null when the solver's board did not change
+ * (no progress possible). Technique 0 (auto-pencilmark / correction hints)
+ * adds no bit; level 0 does not lower the max.
+ */
+export function computeNextExtractionState(state, hints, boardData) {
+    if (!boardData?.user)
+        return null;
+    const pencilmarks = boardData.pencilmark?.numbers ?? '';
+    if (boardData.user === state.userInput && pencilmarks === state.pencilmarks) {
+        return null;
+    }
+    return {
+        userInput: boardData.user,
+        pencilmarks,
+        autoPencilmarks: boardData.pencilmark?.autopencil ?? false,
+        techniquesBitfield: hints.technique > 0
+            ? state.techniquesBitfield |
+                techniqueIdsToBitmask([hints.technique])
+            : state.techniquesBitfield,
+        maxLevel: hints.level > 0 ? Math.max(state.maxLevel, hints.level) : state.maxLevel,
+    };
+}
+/** Final result of a state. */
+export function extractionStateToResult(state) {
+    return { techniques: state.techniquesBitfield, level: state.maxLevel };
+}
+/**
+ * Interpret one /solve response:
+ * - no hint steps → null (no progress)
+ * - an "Invalid Pencilmarks" step → error
+ * - the wanted technique → `found` with the state *before* the step
+ * - otherwise → the next state (null when the board did not change)
+ */
+export function interpretSolveResponse(response, state, desiredTechnique) {
+    const hints = response.data?.hints;
+    if (!response.success || !hints?.steps?.length)
+        return null;
+    if (hasInvalidPencilmarksStep(hints.steps)) {
+        return { error: 'Invalid pencilmarks detected' };
+    }
+    if (desiredTechnique !== undefined &&
+        hints.technique > 0 &&
+        hints.technique === desiredTechnique) {
+        return {
+            type: 'found',
+            userInput: state.userInput,
+            pencilmarks: state.pencilmarks,
+            techniqueId: desiredTechnique,
+            hintData: hints,
+        };
+    }
+    return computeNextExtractionState(state, hints, response.data?.board);
+}
+/**
+ * A thrown /solve call: messages containing "Invalid" or "400" are errors,
+ * anything else (network, timeout) counts as no progress.
+ */
+export function interpretSolveError(err) {
+    const message = errorMessage(err);
+    if (message.includes('Invalid') || message.includes('400')) {
+        return { error: message };
+    }
+    return null;
+}
+/**
+ * Walk `original` with /solve until it is filled or stuck. With
+ * `desiredTechnique`, the solver is filtered to it and the first matching
+ * hint returns `found`. Returns an error after
+ * {@link MAX_EXTRACTION_ITERATIONS} steps.
+ */
+export async function extractBoardTechniques(solve, original, desiredTechnique) {
+    let state = createInitialExtractionState();
+    for (let i = 0; i < MAX_EXTRACTION_ITERATIONS; i++) {
+        if (isPuzzleFilled(original, state.userInput)) {
+            return extractionStateToResult(state);
+        }
+        let step;
+        try {
+            const response = await solve(buildExtractionSolveOptions(original, state, desiredTechnique));
+            step = interpretSolveResponse(response, state, desiredTechnique);
+        }
+        catch (err) {
+            step = interpretSolveError(err);
+        }
+        if (step === null)
+            return extractionStateToResult(state);
+        if (isExtractionError(step) || isTechniqueFound(step))
+            return step;
+        state = step;
+    }
+    return { error: 'Max iterations exceeded' };
+}
+//# sourceMappingURL=extraction.js.map

package/dist/admin/extraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.js","sourceRoot":"","sources":["../../src/admin/extraction.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Single-board technique extraction: walk one board to completion with\n * repeated /solve calls, accumulating the techniques bitmask and max level,\n * or stop early when a wanted technique shows up.\n *\n * The step logic is pure; `extractBoardTechniques` is the loop and takes the\n * solve call as a function, so it works with any transport (the hooks pass a\n * `useSolverSolveMutation` call).\n *\n * Ported from `sudojo_app/src/utils/admin/SingleBoardExtractor.ts`.\n */\n\nimport {\n  type BaseResponse,\n  EMPTY_BOARD,\n  hasPencilmarkContent,\n  type SolveData,\n  type SolveOptions,\n  type SolverBoard,\n  type SolverHints,\n  type TechniqueId,\n  techniqueIdsToBitmask,\n} from '@sudobility/sudojo_types';\nimport {\n  errorMessage,\n  hasInvalidPencilmarksStep,\n  isPuzzleFilled,\n} from './boardStrings';\n\n/** Give up on a board after this many /solve steps. */\nexport const MAX_EXTRACTION_ITERATIONS = 200;\n\n/** Techniques and level found by walking a board to the end. */\nexport interface BoardExtractionResult {\n  /** Exact techniques bitmask (bit N = technique N); can exceed 2^53 */\n  readonly techniques: bigint;\n  readonly level: number;\n}\n\n/** Extraction stopped with an error (e.g. invalid pencilmarks). */\nexport interface BoardExtractionError {\n  readonly error: string;\n}\n\n/** The wanted technique was reached; the board state where it applies. */\nexport interface TechniqueExampleFound {\n  readonly type: 'found';\n  /** Solver-filled cells only (no givens); merge with the original board. */\n  readonly userInput: string;\n  readonly pencilmarks: string;\n  readonly techniqueId: TechniqueId;\n  /** Full `SolverHints` for the step, all steps included */\n  readonly hintData: SolverHints;\n}\n\nexport type BoardExtractionOutcome =\n  | BoardExtractionResult\n  | TechniqueExampleFound\n  | BoardExtractionError;\n\n/** Board state carried between /solve steps. */\nexport interface ExtractionState {\n  readonly userInput: string;\n  readonly pencilmarks: string;\n  readonly autoPencilmarks: boolean;\n  readonly techniquesBitfield: bigint;\n  readonly maxLevel: number;\n}\n\n/** One step's outcome: a new state, a find, an error, or null (no progress). */\nexport type ExtractionStepOutcome =\n  | ExtractionState\n  | TechniqueExampleFound\n  | BoardExtractionError\n  | null;\n\n/** Type guards for the outcome unions. */\nexport const isExtractionError = (\n  value: BoardExtractionOutcome | ExtractionStepOutcome\n): value is BoardExtractionError => value !== null && 'error' in value;\n\nexport const isTechniqueFound = (\n  value: BoardExtractionOutcome | ExtractionStepOutcome\n): value is TechniqueExampleFound =>\n  value !== null && 'type' in value && value.type === 'found';\n\n/** Initial state: empty user grid, no pencilmarks, auto-pencilmarks off. */\nexport function createInitialExtractionState(): ExtractionState {\n  return {\n    userInput: EMPTY_BOARD,\n    pencilmarks: '',\n    autoPencilmarks: false,\n    techniquesBitfield: 0n,\n    maxLevel: 0,\n  };\n}\n\n/**\n * Solve request for the current state. Pencilmarks (and the auto-pencilmark\n * flag) are only sent when the state has pencilmark content; `techniques`\n * filters the solver to the wanted technique.\n */\nexport function buildExtractionSolveOptions(\n  original: string,\n  state: ExtractionState,\n  desiredTechnique?: TechniqueId\n): SolveOptions {\n  const hasPencilmarks =\n    state.pencilmarks !== '' && hasPencilmarkContent(state.pencilmarks);\n  const options: SolveOptions = {\n    original,\n    user: state.userInput,\n    autoPencilmarks: hasPencilmarks ? state.autoPencilmarks : false,\n  };\n  if (hasPencilmarks) options.pencilmarks = state.pencilmarks;\n  if (desiredTechnique !== undefined) {\n    options.techniques = desiredTechnique.toString();\n  }\n  return options;\n}\n\n/**\n * Next state from a hint, or null when the solver's board did not change\n * (no progress possible). Technique 0 (auto-pencilmark / correction hints)\n * adds no bit; level 0 does not lower the max.\n */\nexport function computeNextExtractionState(\n  state: ExtractionState,\n  hints: SolverHints,\n  boardData: SolverBoard | undefined | null\n): ExtractionState | null {\n  if (!boardData?.user) return null;\n\n  const pencilmarks = boardData.pencilmark?.numbers ?? '';\n  if (boardData.user === state.userInput && pencilmarks === state.pencilmarks) {\n    return null;\n  }\n\n  return {\n    userInput: boardData.user,\n    pencilmarks,\n    autoPencilmarks: boardData.pencilmark?.autopencil ?? false,\n    techniquesBitfield:\n      hints.technique > 0\n        ? state.techniquesBitfield |\n          techniqueIdsToBitmask([hints.technique as TechniqueId])\n        : state.techniquesBitfield,\n    maxLevel:\n      hints.level > 0 ? Math.max(state.maxLevel, hints.level) : state.maxLevel,\n  };\n}\n\n/** Final result of a state. */\nexport function extractionStateToResult(\n  state: ExtractionState\n): BoardExtractionResult {\n  return { techniques: state.techniquesBitfield, level: state.maxLevel };\n}\n\n/**\n * Interpret one /solve response:\n * - no hint steps → null (no progress)\n * - an \"Invalid Pencilmarks\" step → error\n * - the wanted technique → `found` with the state *before* the step\n * - otherwise → the next state (null when the board did not change)\n */\nexport function interpretSolveResponse(\n  response: BaseResponse<SolveData>,\n  state: ExtractionState,\n  desiredTechnique?: TechniqueId\n): ExtractionStepOutcome {\n  const hints = response.data?.hints;\n  if (!response.success || !hints?.steps?.length) return null;\n\n  if (hasInvalidPencilmarksStep(hints.steps)) {\n    return { error: 'Invalid pencilmarks detected' };\n  }\n\n  if (\n    desiredTechnique !== undefined &&\n    hints.technique > 0 &&\n    hints.technique === desiredTechnique\n  ) {\n    return {\n      type: 'found',\n      userInput: state.userInput,\n      pencilmarks: state.pencilmarks,\n      techniqueId: desiredTechnique,\n      hintData: hints,\n    };\n  }\n\n  return computeNextExtractionState(state, hints, response.data?.board);\n}\n\n/**\n * A thrown /solve call: messages containing \"Invalid\" or \"400\" are errors,\n * anything else (network, timeout) counts as no progress.\n */\nexport function interpretSolveError(err: unknown): BoardExtractionError | null {\n  const message = errorMessage(err);\n  if (message.includes('Invalid') || message.includes('400')) {\n    return { error: message };\n  }\n  return null;\n}\n\n/** Performs one /solve call. */\nexport type SolveFn = (\n  options: SolveOptions\n) => Promise<BaseResponse<SolveData>>;\n\n/**\n * Walk `original` with /solve until it is filled or stuck. With\n * `desiredTechnique`, the solver is filtered to it and the first matching\n * hint returns `found`. Returns an error after\n * {@link MAX_EXTRACTION_ITERATIONS} steps.\n */\nexport async function extractBoardTechniques(\n  solve: SolveFn,\n  original: string,\n  desiredTechnique?: TechniqueId\n): Promise<BoardExtractionOutcome> {\n  let state = createInitialExtractionState();\n\n  for (let i = 0; i < MAX_EXTRACTION_ITERATIONS; i++) {\n    if (isPuzzleFilled(original, state.userInput)) {\n      return extractionStateToResult(state);\n    }\n\n    let step: ExtractionStepOutcome;\n    try {\n      const response = await solve(\n        buildExtractionSolveOptions(original, state, desiredTechnique)\n      );\n      step = interpretSolveResponse(response, state, desiredTechnique);\n    } catch (err) {\n      step = interpretSolveError(err);\n    }\n\n    if (step === null) return extractionStateToResult(state);\n    if (isExtractionError(step) || isTechniqueFound(step)) return step;\n    state = step;\n  }\n\n  return { error: 'Max iterations exceeded' };\n}\n"]}

package/dist/admin/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Admin batch jobs (board generation, technique extraction, example
+ * creation) and admin stats. Network calls go only through sudojo_client
+ * hooks; see `adminApi.ts`.
+ */
+export type { AbortHandle, AdminJobOptions, AdminJobState } from './types';
+export { ADMIN_JOB_LOG_LIMIT, ADMIN_TOKEN_REFRESH_INTERVAL, createAbortHandle, } from './types';
+export { adjustPracticeSolution, describeTechniqueMask, formatTechniqueMaskHex, hasInvalidPencilmarksStep, isPuzzleFilled, isPuzzleSolved, levelToSave, mergeBoardWithUserInput, } from './boardStrings';
+export type { BoardExtractionError, BoardExtractionOutcome, BoardExtractionResult, ExtractionState, ExtractionStepOutcome, SolveFn, TechniqueExampleFound, } from './extraction';
+export { buildExtractionSolveOptions, computeNextExtractionState, createInitialExtractionState, extractBoardTechniques, extractionStateToResult, interpretSolveError, interpretSolveResponse, isExtractionError, isTechniqueFound, MAX_EXTRACTION_ITERATIONS, } from './extraction';
+export type { ExtractionMismatch, GeneratedPuzzle, ParseGeneratedBoardResult, ValidatedBoard, } from './boardRules';
+export { boardsAtLevelQuery, boardsWithoutTechniquesQuery, boardsWithTechniqueQuery, buildBoardTechniquesUpdate, buildValidatedBoard, compareExtractionWithSolver, parseGeneratedBoard, } from './boardRules';
+export type { ExampleSaveRequests, TechniqueCounts } from './examples';
+export { ADMIN_EXAMPLE_TARGET_PER_TECHNIQUE, ADMIN_TECHNIQUE_ORDER, BOARDS_PER_LEVEL_LIMIT, BOARDS_WITH_TECHNIQUE_LIMIT, buildExampleSaveRequests, buildTechniqueLevelMap, countForTechnique, hasReachedTarget, levelsToSearchForTechnique, normalizeTechniqueCounts, techniquesNeedingExamples, totalTechniqueCount, } from './examples';
+export type { AdminApi } from './adminApi';
+export { useAdminApi } from './adminApi';
+export type { AdminJobContext, AdminTokenManager, BoardGenerationOptions, ExampleCreationCallbacks, ExampleCreationRequest, TechniqueExtractionOptions, } from './jobs';
+export { createAdminTokenManager, fetchBoardsWithTechnique, fetchBoardWithoutTechniques, runBoardGeneration, runExampleCreation, runTechniqueExtraction, shouldRefreshToken, updateBoardTechniques, } from './jobs';
+export type { GeneratedBoardInfo, UseBoardGeneratorOptions, UseBoardGeneratorResult, } from './useBoardGenerator';
+export { useBoardGenerator } from './useBoardGenerator';
+export type { UseTechniqueExtractorOptions, UseTechniqueExtractorResult, } from './useTechniqueExtractor';
+export { useTechniqueExtractor } from './useTechniqueExtractor';
+export type { UseExampleCreatorOptions, UseExampleCreatorResult, } from './useExampleCreator';
+export { useExampleCreator } from './useExampleCreator';
+export type { UseSingleBoardExtractorOptions, UseSingleBoardExtractorResult, } from './useSingleBoardExtractor';
+export { useSingleBoardExtractor } from './useSingleBoardExtractor';
+export type { UseBoardTechniquesUpdaterOptions, UseBoardTechniquesUpdaterResult, } from './useBoardTechniquesUpdater';
+export { useBoardTechniquesUpdater } from './useBoardTechniquesUpdater';
+export type { UseAdminStatsOptions, UseAdminStatsResult, } from './useAdminStats';
+export { describeUpdateStatsResult, useAdminStats } from './useAdminStats';
+export { describeRegenerateHintsResponse, describeRegenerateHintsResult, } from './regenerateHints';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/admin/index.js

@@ -0,0 +1,22 @@
+/**
+ * Admin batch jobs (board generation, technique extraction, example
+ * creation) and admin stats. Network calls go only through sudojo_client
+ * hooks; see `adminApi.ts`.
+ */
+export { ADMIN_JOB_LOG_LIMIT, ADMIN_TOKEN_REFRESH_INTERVAL, createAbortHandle, } from './types';
+// Pure board-string and bitmask helpers
+export { adjustPracticeSolution, describeTechniqueMask, formatTechniqueMaskHex, hasInvalidPencilmarksStep, isPuzzleFilled, isPuzzleSolved, levelToSave, mergeBoardWithUserInput, } from './boardStrings';
+export { buildExtractionSolveOptions, computeNextExtractionState, createInitialExtractionState, extractBoardTechniques, extractionStateToResult, interpretSolveError, interpretSolveResponse, isExtractionError, isTechniqueFound, MAX_EXTRACTION_ITERATIONS, } from './extraction';
+export { boardsAtLevelQuery, boardsWithoutTechniquesQuery, boardsWithTechniqueQuery, buildBoardTechniquesUpdate, buildValidatedBoard, compareExtractionWithSolver, parseGeneratedBoard, } from './boardRules';
+export { ADMIN_EXAMPLE_TARGET_PER_TECHNIQUE, ADMIN_TECHNIQUE_ORDER, BOARDS_PER_LEVEL_LIMIT, BOARDS_WITH_TECHNIQUE_LIMIT, buildExampleSaveRequests, buildTechniqueLevelMap, countForTechnique, hasReachedTarget, levelsToSearchForTechnique, normalizeTechniqueCounts, techniquesNeedingExamples, totalTechniqueCount, } from './examples';
+export { useAdminApi } from './adminApi';
+export { createAdminTokenManager, fetchBoardsWithTechnique, fetchBoardWithoutTechniques, runBoardGeneration, runExampleCreation, runTechniqueExtraction, shouldRefreshToken, updateBoardTechniques, } from './jobs';
+export { useBoardGenerator } from './useBoardGenerator';
+export { useTechniqueExtractor } from './useTechniqueExtractor';
+export { useExampleCreator } from './useExampleCreator';
+export { useSingleBoardExtractor } from './useSingleBoardExtractor';
+export { useBoardTechniquesUpdater } from './useBoardTechniquesUpdater';
+export { describeUpdateStatsResult, useAdminStats } from './useAdminStats';
+// Regenerate-hints status line
+export { describeRegenerateHintsResponse, describeRegenerateHintsResult, } from './regenerateHints';
+//# sourceMappingURL=index.js.map

package/dist/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,wCAAwC;AACxC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,WAAW,EACX,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAYxB,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAStB,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,kCAAkC,EAClC,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAWzC,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,QAAQ,CAAC;AAQhB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAKpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAKxE,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3E,+BAA+B;AAC/B,OAAO,EACL,+BAA+B,EAC/B,6BAA6B,GAC9B,MAAM,mBAAmB,CAAC","sourcesContent":["/**\n * Admin batch jobs (board generation, technique extraction, example\n * creation) and admin stats. Network calls go only through sudojo_client\n * hooks; see `adminApi.ts`.\n */\n\n// Types and constants\nexport type { AbortHandle, AdminJobOptions, AdminJobState } from './types';\nexport {\n  ADMIN_JOB_LOG_LIMIT,\n  ADMIN_TOKEN_REFRESH_INTERVAL,\n  createAbortHandle,\n} from './types';\n\n// Pure board-string and bitmask helpers\nexport {\n  adjustPracticeSolution,\n  describeTechniqueMask,\n  formatTechniqueMaskHex,\n  hasInvalidPencilmarksStep,\n  isPuzzleFilled,\n  isPuzzleSolved,\n  levelToSave,\n  mergeBoardWithUserInput,\n} from './boardStrings';\n\n// Single-board extraction\nexport type {\n  BoardExtractionError,\n  BoardExtractionOutcome,\n  BoardExtractionResult,\n  ExtractionState,\n  ExtractionStepOutcome,\n  SolveFn,\n  TechniqueExampleFound,\n} from './extraction';\nexport {\n  buildExtractionSolveOptions,\n  computeNextExtractionState,\n  createInitialExtractionState,\n  extractBoardTechniques,\n  extractionStateToResult,\n  interpretSolveError,\n  interpretSolveResponse,\n  isExtractionError,\n  isTechniqueFound,\n  MAX_EXTRACTION_ITERATIONS,\n} from './extraction';\n\n// Board rules\nexport type {\n  ExtractionMismatch,\n  GeneratedPuzzle,\n  ParseGeneratedBoardResult,\n  ValidatedBoard,\n} from './boardRules';\nexport {\n  boardsAtLevelQuery,\n  boardsWithoutTechniquesQuery,\n  boardsWithTechniqueQuery,\n  buildBoardTechniquesUpdate,\n  buildValidatedBoard,\n  compareExtractionWithSolver,\n  parseGeneratedBoard,\n} from './boardRules';\n\n// Example rules\nexport type { ExampleSaveRequests, TechniqueCounts } from './examples';\nexport {\n  ADMIN_EXAMPLE_TARGET_PER_TECHNIQUE,\n  ADMIN_TECHNIQUE_ORDER,\n  BOARDS_PER_LEVEL_LIMIT,\n  BOARDS_WITH_TECHNIQUE_LIMIT,\n  buildExampleSaveRequests,\n  buildTechniqueLevelMap,\n  countForTechnique,\n  hasReachedTarget,\n  levelsToSearchForTechnique,\n  normalizeTechniqueCounts,\n  techniquesNeedingExamples,\n  totalTechniqueCount,\n} from './examples';\n\n// Network surface\nexport type { AdminApi } from './adminApi';\nexport { useAdminApi } from './adminApi';\n\n// Framework-agnostic jobs\nexport type {\n  AdminJobContext,\n  AdminTokenManager,\n  BoardGenerationOptions,\n  ExampleCreationCallbacks,\n  ExampleCreationRequest,\n  TechniqueExtractionOptions,\n} from './jobs';\nexport {\n  createAdminTokenManager,\n  fetchBoardsWithTechnique,\n  fetchBoardWithoutTechniques,\n  runBoardGeneration,\n  runExampleCreation,\n  runTechniqueExtraction,\n  shouldRefreshToken,\n  updateBoardTechniques,\n} from './jobs';\n\n// Hooks\nexport type {\n  GeneratedBoardInfo,\n  UseBoardGeneratorOptions,\n  UseBoardGeneratorResult,\n} from './useBoardGenerator';\nexport { useBoardGenerator } from './useBoardGenerator';\nexport type {\n  UseTechniqueExtractorOptions,\n  UseTechniqueExtractorResult,\n} from './useTechniqueExtractor';\nexport { useTechniqueExtractor } from './useTechniqueExtractor';\nexport type {\n  UseExampleCreatorOptions,\n  UseExampleCreatorResult,\n} from './useExampleCreator';\nexport { useExampleCreator } from './useExampleCreator';\nexport type {\n  UseSingleBoardExtractorOptions,\n  UseSingleBoardExtractorResult,\n} from './useSingleBoardExtractor';\nexport { useSingleBoardExtractor } from './useSingleBoardExtractor';\nexport type {\n  UseBoardTechniquesUpdaterOptions,\n  UseBoardTechniquesUpdaterResult,\n} from './useBoardTechniquesUpdater';\nexport { useBoardTechniquesUpdater } from './useBoardTechniquesUpdater';\nexport type {\n  UseAdminStatsOptions,\n  UseAdminStatsResult,\n} from './useAdminStats';\nexport { describeUpdateStatsResult, useAdminStats } from './useAdminStats';\n\n// Regenerate-hints status line\nexport {\n  describeRegenerateHintsResponse,\n  describeRegenerateHintsResult,\n} from './regenerateHints';\n"]}

package/dist/admin/jobs.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Admin batch jobs as framework-agnostic async functions over an
+ * {@link AdminApi}. The hooks in this folder wrap them with React state; the
+ * functions themselves hold the business rules (token refresh cadence, retry
+ * delays, stop conditions, technique → level search fallback).
+ *
+ * Ported from `sudojo_app/src/utils/admin/{BoardGenerator,TechniqueExtractor,
+ * ExampleCreator,boardTechniquesApi}.ts`; progress messages are unchanged.
+ */
+import { type Board, type TechniqueId } from '@sudobility/sudojo_types';
+import type { AdminApi } from './adminApi';
+import { type TechniqueCounts } from './examples';
+import { type AbortHandle } from './types';
+/** Current admin token, refreshable mid-job. */
+export interface AdminTokenManager {
+    readonly current: string;
+    /** Ask `getToken` again; keeps the old token if it fails or returns null. */
+    refresh(): Promise<void>;
+}
+/**
+ * Get the starting token. Returns null when `getToken` yields none (the job
+ * should report "Not authenticated"). Refreshes log "Token refreshed,
+ * continuing..." through `onProgress`; refresh failures only warn.
+ */
+export declare function createAdminTokenManager(getToken: () => Promise<string | null>, onProgress: (message: string) => void): Promise<AdminTokenManager | null>;
+/** True when the job should refresh its token before item `processed + 1`. */
+export declare function shouldRefreshToken(processed: number, interval?: number): boolean;
+/** What every job needs. */
+export interface AdminJobContext {
+    api: AdminApi;
+    token: AdminTokenManager;
+    abort: AbortHandle;
+    onProgress: (message: string) => void;
+    onError: (error: Error) => void;
+    /** Wait between retries (default: setTimeout). Injectable for tests. */
+    delay?: (ms: number) => Promise<void>;
+}
+/**
+ * Set a board's techniques bitmask (sent as an exact string) and level.
+ * Returns false on any failure.
+ */
+export declare function updateBoardTechniques(api: AdminApi, token: string, boardUuid: string, techniques: bigint, level: number | null): Promise<boolean>;
+/**
+ * Boards with the technique's bit set (API `technique_bit` filter), any
+ * level. Returns [] on any failure.
+ */
+export declare function fetchBoardsWithTechnique(api: AdminApi, token: string, techniqueId: TechniqueId, limit: number): Promise<Board[]>;
+/** The next board whose techniques were never extracted, or null. */
+export declare function fetchBoardWithoutTechniques(api: AdminApi, token: string): Promise<Board | null>;
+export interface BoardGenerationOptions {
+    symmetrical: boolean;
+    /** After each saved board. `techniques` is the exact bitmask. */
+    onBoardGenerated?: (count: number, level: number, techniques: bigint) => void;
+}
+/**
+ * Generate, validate and save boards until aborted or a save fails.
+ * Each board: /generate → /validate (source of truth for level, techniques,
+ * solution) → create. Generate/validate failures wait 1 s and retry.
+ * Returns the number of boards saved.
+ */
+export declare function runBoardGeneration(ctx: AdminJobContext, options: BoardGenerationOptions): Promise<number>;
+export interface TechniqueExtractionOptions {
+    /**
+     * false: trust /validate and save its techniques (fast).
+     * true: walk the board with /solve, compare with /validate, stop on any
+     * mismatch, and save only matching results.
+     */
+    testWithFrontend: boolean;
+    /** After each saved board. */
+    onBoardExtracted?: () => void;
+}
+/**
+ * Process boards without techniques one by one until none are left, aborted,
+ * or a critical error (save failure, mismatch, invalid pencilmarks).
+ * Returns the number of boards saved.
+ */
+export declare function runTechniqueExtraction(ctx: AdminJobContext, options: TechniqueExtractionOptions): Promise<number>;
+/**
+ * - `all`: every technique in `techniqueOrder` below target, by bit then level.
+ * - `bit`: one technique; boards with its bit set, else the level search.
+ * - `level`: one technique; level search only (finds techniques whose bit is
+ *   missing on boards).
+ */
+export type ExampleCreationRequest = {
+    mode: 'all';
+    currentCounts: TechniqueCounts;
+    targetPerTechnique?: number;
+    techniqueOrder?: readonly TechniqueId[];
+} | {
+    mode: 'bit' | 'level';
+    techniqueId: TechniqueId;
+    currentCounts: TechniqueCounts;
+    targetPerTechnique?: number;
+};
+export interface ExampleCreationCallbacks {
+    /** After an example + practice pair is saved. */
+    onExampleSaved?: (techniqueId: TechniqueId, newCount: number) => void;
+    /** After a board whose bit lied was reset to techniques 0 / level null. */
+    onBoardTechniquesReset?: (boardUuid: string) => void;
+}
+/**
+ * Create technique examples (each with a linked practice). A board fetched by
+ * technique bit that turns out not to contain the technique is reset to
+ * techniques 0 so the extractor re-processes it. Any failed save stops the
+ * job (aborts). Returns the final per-technique counts.
+ */
+export declare function runExampleCreation(ctx: AdminJobContext, request: ExampleCreationRequest, callbacks?: ExampleCreationCallbacks): Promise<Record<number, number>>;
+//# sourceMappingURL=jobs.d.ts.map

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

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