@sudobility/sudojo_lib 0.0.201 → 0.0.203

package/dist/utils/technique.js

@@ -1,5 +1,297 @@
 /**
- * Technique-related utilities
+ * Technique and strategy utilities: path aliases, dependencies, grouping,
+ * slug lists, difficulty tiers, and the localized learning content.
  */
 export { getTechniqueIconUrl } from '@sudobility/sudojo_types';
+// =============================================================================
+// Technique path aliases
+// =============================================================================
+/**
+ * API `path` → public slug, for techniques whose API path differs from the
+ * public URL slug and their key in `techniques.json`. The web app also
+ * 301-redirects `/techniques/3d-medusa` to `/techniques/medusa-coloring`.
+ */
+const API_TO_CANONICAL_TECHNIQUE_PATH = {
+    '3d-medusa': 'medusa-coloring',
+};
+const CANONICAL_TO_API_TECHNIQUE_PATH = Object.fromEntries(Object.entries(API_TO_CANONICAL_TECHNIQUE_PATH).map(([apiPath, canonicalPath]) => [canonicalPath, apiPath]));
+// eslint-disable-next-line no-redeclare -- overload
+export function toCanonicalTechniquePath(path) {
+    if (!path)
+        return undefined;
+    return API_TO_CANONICAL_TECHNIQUE_PATH[path] || path;
+}
+// eslint-disable-next-line no-redeclare -- overload
+export function toApiTechniquePath(path) {
+    if (!path)
+        return undefined;
+    return CANONICAL_TO_API_TECHNIQUE_PATH[path] || path;
+}
+/** Whether two technique paths name the same technique, aliases included. */
+export function isSameTechniquePath(a, b) {
+    if (!a || !b)
+        return false;
+    return toCanonicalTechniquePath(a) === toCanonicalTechniquePath(b);
+}
+/**
+ * Find a technique by path, accepting either the API path or the canonical
+ * slug (`3d-medusa` and `medusa-coloring` both find 3D Medusa).
+ */
+export function findTechniqueByPath(techniques, path) {
+    if (!path)
+        return undefined;
+    return techniques.find(t => isSameTechniquePath(t.path, path));
+}
+// =============================================================================
+// Dependencies
+// =============================================================================
+/**
+ * Parse a technique's comma-separated `dependencies` field into technique ids.
+ * Blank and non-numeric entries are dropped.
+ */
+export function parseTechniqueDependencies(dependencies) {
+    if (!dependencies)
+        return [];
+    return dependencies
+        .split(',')
+        .map(s => parseInt(s.trim(), 10))
+        .filter(n => !isNaN(n));
+}
+/**
+ * The techniques a technique builds on ("Requires"), in the order of `all`.
+ */
+export function getTechniqueDependencies(technique, all) {
+    const ids = parseTechniqueDependencies(technique?.dependencies);
+    if (ids.length === 0)
+        return [];
+    return all.filter(t => ids.includes(t.technique));
+}
+/**
+ * The techniques that list this one as a dependency ("Learn after"),
+ * in the order of `all`.
+ */
+export function getDependentTechniques(technique, all) {
+    if (!technique)
+        return [];
+    const id = technique.technique;
+    return all.filter(t => parseTechniqueDependencies(t.dependencies).includes(id));
+}
+// =============================================================================
+// Grouping and sorting
+// =============================================================================
+/** Sort techniques by level (unassigned first), then by technique number. */
+export function sortTechniquesByLevel(techniques) {
+    return [...techniques].sort((a, b) => {
+        if (a.level !== b.level) {
+            return (a.level ?? 0) - (b.level ?? 0);
+        }
+        return a.technique - b.technique;
+    });
+}
+/**
+ * Group techniques by level, each group sorted by technique number, keys in
+ * ascending level order. This is what useTechniques' `techniquesByLevel` returns.
+ *
+ * @param options.includeUnassigned - Keep techniques with no level under key 0
+ *   (default true, like useTechniques). The web TechniquesPage drops them: pass false.
+ */
+export function groupTechniquesByLevel(techniques, options = {}) {
+    const { includeUnassigned = true } = options;
+    const byLevel = new Map();
+    for (const technique of sortTechniquesByLevel(techniques)) {
+        const key = technique.level ?? 0;
+        if (key === 0 && !includeUnassigned)
+            continue;
+        const existing = byLevel.get(key) ?? [];
+        existing.push(technique);
+        byLevel.set(key, existing);
+    }
+    return byLevel;
+}
+/**
+ * The techniques in a strategy, sorted by technique number (as the web
+ * StrategiesPage and the RN strategy screens list them).
+ */
+export function getTechniquesForStrategy(techniques, strategyId) {
+    if (strategyId == null)
+        return [];
+    return techniques
+        .filter(t => t.strategy_id === strategyId)
+        .sort((a, b) => a.technique - b.technique);
+}
+/** Find a strategy by its URL stub. */
+export function findStrategyByStub(strategies, stub) {
+    if (!stub)
+        return undefined;
+    return strategies.find(s => s.stub === stub);
+}
+// =============================================================================
+// Slug lists
+// =============================================================================
+/**
+ * Public slugs of all 60 techniques, in footer / sitemap order (canonical
+ * slugs, e.g. `medusa-coloring`). Same list as sudojo_app's useFooterConfig
+ * and SitemapPage.
+ */
+export const TECHNIQUE_SLUGS = [
+    'full-house',
+    'hidden-single',
+    'naked-single',
+    'hidden-pair',
+    'naked-pair',
+    'locked-candidates',
+    'hidden-triple',
+    'naked-triple',
+    'hidden-quad',
+    'naked-quad',
+    'x-wing',
+    'swordfish',
+    'jellyfish',
+    'xy-wing',
+    'finned-x-wing',
+    'squirmbag',
+    'finned-swordfish',
+    'finned-jellyfish',
+    'xyz-wing',
+    'wxyz-wing',
+    'almost-locked-sets',
+    'finned-squirmbag',
+    'als-chain',
+    'skyscraper',
+    'two-string-kite',
+    'empty-rectangle',
+    'simple-coloring',
+    'w-wing',
+    'remote-pairs',
+    'unique-rectangle-type-1',
+    'unique-rectangle-type-2',
+    'bug-1',
+    'sue-de-coq',
+    'als-xz',
+    'x-cycles',
+    'forcing-chains',
+    'medusa-coloring',
+    'crane',
+    'unique-rectangle-type-3',
+    'unique-rectangle-type-4',
+    'unique-rectangle-type-5',
+    'x-chain',
+    'xy-chain',
+    'vwxyz-wing',
+    'uvwxyz-wing',
+    'tuvwxyz-wing',
+    'stuvwxyz-wing',
+    'aic',
+    'forcing-net',
+    'avoidable-rectangle',
+    'sashimi-x-wing',
+    'sashimi-swordfish',
+    'sashimi-jellyfish',
+    'hidden-unique-rectangle',
+    'firework',
+    'death-blossom',
+    'franken-x-wing',
+    'franken-swordfish',
+    'franken-jellyfish',
+    'grouped-x-cycles',
+];
+/** Stubs of the 17 strategies, in difficulty order (sudojo_app's footer list). */
+export const STRATEGY_SLUGS = [
+    'naked-subsets',
+    'hidden-subsets',
+    'locked-candidates',
+    'basic-fish',
+    'finned-sashimi-fish',
+    'franken-fish',
+    'single-digit-patterns',
+    'wings',
+    'unique-rectangles',
+    'coloring',
+    'remote-pairs',
+    'almost-locked-sets',
+    'bug-plus-one',
+    'firework',
+    'single-digit-chains',
+    'multi-digit-chains',
+    'forcing',
+];
+/**
+ * Tier for a strategy's `difficulty`: ≤3 beginner, ≤5 intermediate,
+ * ≤9 advanced, ≤12 expert, otherwise master.
+ */
+export function getStrategyDifficultyTier(difficulty) {
+    if (difficulty <= 3)
+        return 'beginner';
+    if (difficulty <= 5)
+        return 'intermediate';
+    if (difficulty <= 9)
+        return 'advanced';
+    if (difficulty <= 12)
+        return 'expert';
+    return 'master';
+}
+/** i18n key (default namespace) for a strategy's tier, e.g. `strategy.expert`. */
+export function getStrategyDifficultyKey(difficulty) {
+    return `strategy.${getStrategyDifficultyTier(difficulty)}`;
+}
+/** Most sections a strategy can have in `strategies.json`. */
+const MAX_STRATEGY_SECTIONS = 20;
+/**
+ * Translate `key`, returning '' on a miss (missing key echoed back or empty).
+ */
+function translateOrEmpty(t, key) {
+    const translated = t(key, { defaultValue: '' });
+    return translated && translated !== key ? translated : '';
+}
+/**
+ * Collect the sections of a strategy from the `strategies` namespace:
+ * `${stub}.1.title` / `${stub}.1.text`, `${stub}.2.*`, ... up to 20, stopping
+ * at the first missing title.
+ *
+ * @param t - Translate function for the `strategies` namespace
+ */
+export function getStrategySections(t, stub) {
+    if (!stub)
+        return [];
+    const result = [];
+    for (let n = 1; n <= MAX_STRATEGY_SECTIONS; n++) {
+        const key = `${stub}.${n}`;
+        const title = translateOrEmpty(t, `${key}.title`);
+        if (!title)
+            break;
+        const text = translateOrEmpty(t, `${key}.text`);
+        result.push({
+            title,
+            text,
+            paragraphs: text.split('\n').filter(p => p.trim()),
+        });
+    }
+    return result;
+}
+/**
+ * Read a technique's overview, how-it-works steps and tips.
+ *
+ * The path is canonicalized (`3d-medusa` → `medusa-coloring`), which is how
+ * `techniques.json` is keyed.
+ *
+ * @param t - Translate function for the `techniques` namespace
+ */
+export function parseTechniqueContent(t, path) {
+    const key = toCanonicalTechniquePath(path);
+    if (!key)
+        return { overview: '', howItWorks: [], tips: [] };
+    const howItWorks = translateOrEmpty(t, `${key}.how-it-works`);
+    const tips = translateOrEmpty(t, `${key}.tips`);
+    return {
+        overview: translateOrEmpty(t, `${key}.overview`),
+        howItWorks: howItWorks
+            .split('\n')
+            .filter(Boolean)
+            .map(step => step.replace(/^\d+\.\s*/, '')),
+        tips: tips
+            .split(/(?<=\.)\s+/)
+            .filter(Boolean)
+            .map(tip => tip.trim()),
+    };
+}
 //# sourceMappingURL=technique.js.map

package/dist/utils/technique.js.map

@@ -1 +1 @@
-{"version":3,"file":"technique.js","sourceRoot":"","sources":["../../src/utils/technique.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["/**\n * Technique-related utilities\n */\n\nexport { getTechniqueIconUrl } from '@sudobility/sudojo_types';\n"]}
+{"version":3,"file":"technique.js","sourceRoot":"","sources":["../../src/utils/technique.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Technique and strategy utilities: path aliases, dependencies, grouping,\n * slug lists, difficulty tiers, and the localized learning content.\n */\n\nimport type { Strategy, Technique } from '@sudobility/sudojo_types';\nimport type { TranslateFunction } from './localizedHint';\n\nexport { getTechniqueIconUrl } from '@sudobility/sudojo_types';\n\n// =============================================================================\n// Technique path aliases\n// =============================================================================\n\n/**\n * API `path` → public slug, for techniques whose API path differs from the\n * public URL slug and their key in `techniques.json`. The web app also\n * 301-redirects `/techniques/3d-medusa` to `/techniques/medusa-coloring`.\n */\nconst API_TO_CANONICAL_TECHNIQUE_PATH: Readonly<Record<string, string>> = {\n  '3d-medusa': 'medusa-coloring',\n};\n\nconst CANONICAL_TO_API_TECHNIQUE_PATH: Readonly<Record<string, string>> =\n  Object.fromEntries(\n    Object.entries(API_TO_CANONICAL_TECHNIQUE_PATH).map(\n      ([apiPath, canonicalPath]) => [canonicalPath, apiPath]\n    )\n  );\n\n/**\n * The public slug for a technique path (URL, share link, locale key).\n * `3d-medusa` → `medusa-coloring`; other paths are returned unchanged.\n */\nexport function toCanonicalTechniquePath(path: string): string;\n// eslint-disable-next-line no-redeclare -- overload\nexport function toCanonicalTechniquePath(\n  path: string | null | undefined\n): string | undefined;\n// eslint-disable-next-line no-redeclare -- overload\nexport function toCanonicalTechniquePath(\n  path: string | null | undefined\n): string | undefined {\n  if (!path) return undefined;\n  return API_TO_CANONICAL_TECHNIQUE_PATH[path] || path;\n}\n\n/**\n * The API's `path` for a technique slug. `medusa-coloring` → `3d-medusa`;\n * other paths are returned unchanged.\n */\nexport function toApiTechniquePath(path: string): string;\n// eslint-disable-next-line no-redeclare -- overload\nexport function toApiTechniquePath(\n  path: string | null | undefined\n): string | undefined;\n// eslint-disable-next-line no-redeclare -- overload\nexport function toApiTechniquePath(\n  path: string | null | undefined\n): string | undefined {\n  if (!path) return undefined;\n  return CANONICAL_TO_API_TECHNIQUE_PATH[path] || path;\n}\n\n/** Whether two technique paths name the same technique, aliases included. */\nexport function isSameTechniquePath(\n  a: string | null | undefined,\n  b: string | null | undefined\n): boolean {\n  if (!a || !b) return false;\n  return toCanonicalTechniquePath(a) === toCanonicalTechniquePath(b);\n}\n\n/**\n * Find a technique by path, accepting either the API path or the canonical\n * slug (`3d-medusa` and `medusa-coloring` both find 3D Medusa).\n */\nexport function findTechniqueByPath<T extends Pick<Technique, 'path'>>(\n  techniques: readonly T[],\n  path: string | null | undefined\n): T | undefined {\n  if (!path) return undefined;\n  return techniques.find(t => isSameTechniquePath(t.path, path));\n}\n\n// =============================================================================\n// Dependencies\n// =============================================================================\n\n/**\n * Parse a technique's comma-separated `dependencies` field into technique ids.\n * Blank and non-numeric entries are dropped.\n */\nexport function parseTechniqueDependencies(\n  dependencies: string | null | undefined\n): number[] {\n  if (!dependencies) return [];\n  return dependencies\n    .split(',')\n    .map(s => parseInt(s.trim(), 10))\n    .filter(n => !isNaN(n));\n}\n\n/**\n * The techniques a technique builds on (\"Requires\"), in the order of `all`.\n */\nexport function getTechniqueDependencies<\n  T extends Pick<Technique, 'technique'>,\n>(\n  technique: Pick<Technique, 'dependencies'> | null | undefined,\n  all: readonly T[]\n): T[] {\n  const ids = parseTechniqueDependencies(technique?.dependencies);\n  if (ids.length === 0) return [];\n  return all.filter(t => ids.includes(t.technique));\n}\n\n/**\n * The techniques that list this one as a dependency (\"Learn after\"),\n * in the order of `all`.\n */\nexport function getDependentTechniques<\n  T extends Pick<Technique, 'technique' | 'dependencies'>,\n>(\n  technique: Pick<Technique, 'technique'> | null | undefined,\n  all: readonly T[]\n): T[] {\n  if (!technique) return [];\n  const id = technique.technique;\n  return all.filter(t =>\n    parseTechniqueDependencies(t.dependencies).includes(id)\n  );\n}\n\n// =============================================================================\n// Grouping and sorting\n// =============================================================================\n\n/** Sort techniques by level (unassigned first), then by technique number. */\nexport function sortTechniquesByLevel<\n  T extends Pick<Technique, 'technique' | 'level'>,\n>(techniques: readonly T[]): T[] {\n  return [...techniques].sort((a, b) => {\n    if (a.level !== b.level) {\n      return (a.level ?? 0) - (b.level ?? 0);\n    }\n    return a.technique - b.technique;\n  });\n}\n\n/**\n * Group techniques by level, each group sorted by technique number, keys in\n * ascending level order. This is what useTechniques' `techniquesByLevel` returns.\n *\n * @param options.includeUnassigned - Keep techniques with no level under key 0\n *   (default true, like useTechniques). The web TechniquesPage drops them: pass false.\n */\nexport function groupTechniquesByLevel<\n  T extends Pick<Technique, 'technique' | 'level'>,\n>(\n  techniques: readonly T[],\n  options: { includeUnassigned?: boolean } = {}\n): Map<number, T[]> {\n  const { includeUnassigned = true } = options;\n  const byLevel = new Map<number, T[]>();\n  for (const technique of sortTechniquesByLevel(techniques)) {\n    const key = technique.level ?? 0;\n    if (key === 0 && !includeUnassigned) continue;\n    const existing = byLevel.get(key) ?? [];\n    existing.push(technique);\n    byLevel.set(key, existing);\n  }\n  return byLevel;\n}\n\n/**\n * The techniques in a strategy, sorted by technique number (as the web\n * StrategiesPage and the RN strategy screens list them).\n */\nexport function getTechniquesForStrategy<\n  T extends Pick<Technique, 'technique' | 'strategy_id'>,\n>(techniques: readonly T[], strategyId: number | null | undefined): T[] {\n  if (strategyId == null) return [];\n  return techniques\n    .filter(t => t.strategy_id === strategyId)\n    .sort((a, b) => a.technique - b.technique);\n}\n\n/** Find a strategy by its URL stub. */\nexport function findStrategyByStub<S extends Pick<Strategy, 'stub'>>(\n  strategies: readonly S[],\n  stub: string | null | undefined\n): S | undefined {\n  if (!stub) return undefined;\n  return strategies.find(s => s.stub === stub);\n}\n\n// =============================================================================\n// Slug lists\n// =============================================================================\n\n/**\n * Public slugs of all 60 techniques, in footer / sitemap order (canonical\n * slugs, e.g. `medusa-coloring`). Same list as sudojo_app's useFooterConfig\n * and SitemapPage.\n */\nexport const TECHNIQUE_SLUGS = [\n  'full-house',\n  'hidden-single',\n  'naked-single',\n  'hidden-pair',\n  'naked-pair',\n  'locked-candidates',\n  'hidden-triple',\n  'naked-triple',\n  'hidden-quad',\n  'naked-quad',\n  'x-wing',\n  'swordfish',\n  'jellyfish',\n  'xy-wing',\n  'finned-x-wing',\n  'squirmbag',\n  'finned-swordfish',\n  'finned-jellyfish',\n  'xyz-wing',\n  'wxyz-wing',\n  'almost-locked-sets',\n  'finned-squirmbag',\n  'als-chain',\n  'skyscraper',\n  'two-string-kite',\n  'empty-rectangle',\n  'simple-coloring',\n  'w-wing',\n  'remote-pairs',\n  'unique-rectangle-type-1',\n  'unique-rectangle-type-2',\n  'bug-1',\n  'sue-de-coq',\n  'als-xz',\n  'x-cycles',\n  'forcing-chains',\n  'medusa-coloring',\n  'crane',\n  'unique-rectangle-type-3',\n  'unique-rectangle-type-4',\n  'unique-rectangle-type-5',\n  'x-chain',\n  'xy-chain',\n  'vwxyz-wing',\n  'uvwxyz-wing',\n  'tuvwxyz-wing',\n  'stuvwxyz-wing',\n  'aic',\n  'forcing-net',\n  'avoidable-rectangle',\n  'sashimi-x-wing',\n  'sashimi-swordfish',\n  'sashimi-jellyfish',\n  'hidden-unique-rectangle',\n  'firework',\n  'death-blossom',\n  'franken-x-wing',\n  'franken-swordfish',\n  'franken-jellyfish',\n  'grouped-x-cycles',\n] as const;\n\n/** A public technique slug. */\nexport type TechniqueSlug = (typeof TECHNIQUE_SLUGS)[number];\n\n/** Stubs of the 17 strategies, in difficulty order (sudojo_app's footer list). */\nexport const STRATEGY_SLUGS = [\n  'naked-subsets',\n  'hidden-subsets',\n  'locked-candidates',\n  'basic-fish',\n  'finned-sashimi-fish',\n  'franken-fish',\n  'single-digit-patterns',\n  'wings',\n  'unique-rectangles',\n  'coloring',\n  'remote-pairs',\n  'almost-locked-sets',\n  'bug-plus-one',\n  'firework',\n  'single-digit-chains',\n  'multi-digit-chains',\n  'forcing',\n] as const;\n\n/** A strategy stub. */\nexport type StrategySlug = (typeof STRATEGY_SLUGS)[number];\n\n// =============================================================================\n// Strategy difficulty and content\n// =============================================================================\n\n/** Difficulty tier of a strategy, shown as a badge. */\nexport type StrategyDifficultyTier =\n  | 'beginner'\n  | 'intermediate'\n  | 'advanced'\n  | 'expert'\n  | 'master';\n\n/**\n * Tier for a strategy's `difficulty`: ≤3 beginner, ≤5 intermediate,\n * ≤9 advanced, ≤12 expert, otherwise master.\n */\nexport function getStrategyDifficultyTier(\n  difficulty: number\n): StrategyDifficultyTier {\n  if (difficulty <= 3) return 'beginner';\n  if (difficulty <= 5) return 'intermediate';\n  if (difficulty <= 9) return 'advanced';\n  if (difficulty <= 12) return 'expert';\n  return 'master';\n}\n\n/** i18n key (default namespace) for a strategy's tier, e.g. `strategy.expert`. */\nexport function getStrategyDifficultyKey(difficulty: number): string {\n  return `strategy.${getStrategyDifficultyTier(difficulty)}`;\n}\n\n/** Most sections a strategy can have in `strategies.json`. */\nconst MAX_STRATEGY_SECTIONS = 20;\n\n/** One section of a strategy's localized description. */\nexport interface StrategySection {\n  /** Section title */\n  title: string;\n  /** Section body ('' when missing) */\n  text: string;\n  /** Non-blank lines of `text` */\n  paragraphs: string[];\n}\n\n/**\n * Translate `key`, returning '' on a miss (missing key echoed back or empty).\n */\nfunction translateOrEmpty(t: TranslateFunction, key: string): string {\n  const translated = t(key, { defaultValue: '' });\n  return translated && translated !== key ? translated : '';\n}\n\n/**\n * Collect the sections of a strategy from the `strategies` namespace:\n * `${stub}.1.title` / `${stub}.1.text`, `${stub}.2.*`, ... up to 20, stopping\n * at the first missing title.\n *\n * @param t - Translate function for the `strategies` namespace\n */\nexport function getStrategySections(\n  t: TranslateFunction,\n  stub: string | null | undefined\n): StrategySection[] {\n  if (!stub) return [];\n  const result: StrategySection[] = [];\n  for (let n = 1; n <= MAX_STRATEGY_SECTIONS; n++) {\n    const key = `${stub}.${n}`;\n    const title = translateOrEmpty(t, `${key}.title`);\n    if (!title) break;\n    const text = translateOrEmpty(t, `${key}.text`);\n    result.push({\n      title,\n      text,\n      paragraphs: text.split('\\n').filter(p => p.trim()),\n    });\n  }\n  return result;\n}\n\n/** A technique's localized learning content from the `techniques` namespace. */\nexport interface TechniqueContent {\n  /** `${path}.overview`, or '' */\n  overview: string;\n  /** `${path}.how-it-works`, one entry per line, leading \"1. \" numbering removed */\n  howItWorks: string[];\n  /** `${path}.tips`, split into sentences */\n  tips: string[];\n}\n\n/**\n * Read a technique's overview, how-it-works steps and tips.\n *\n * The path is canonicalized (`3d-medusa` → `medusa-coloring`), which is how\n * `techniques.json` is keyed.\n *\n * @param t - Translate function for the `techniques` namespace\n */\nexport function parseTechniqueContent(\n  t: TranslateFunction,\n  path: string | null | undefined\n): TechniqueContent {\n  const key = toCanonicalTechniquePath(path);\n  if (!key) return { overview: '', howItWorks: [], tips: [] };\n  const howItWorks = translateOrEmpty(t, `${key}.how-it-works`);\n  const tips = translateOrEmpty(t, `${key}.tips`);\n  return {\n    overview: translateOrEmpty(t, `${key}.overview`),\n    howItWorks: howItWorks\n      .split('\\n')\n      .filter(Boolean)\n      .map(step => step.replace(/^\\d+\\.\\s*/, '')),\n    tips: tips\n      .split(/(?<=\\.)\\s+/)\n      .filter(Boolean)\n      .map(tip => tip.trim()),\n  };\n}\n"]}

package/dist/utils/techniqueBitmask.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Exact technique bitmasks for game pages.
+ *
+ * Bit N = technique id N (1-60). A mask with any id >= 54 set exceeds 2^53, so
+ * the numeric `techniques` field from the API is lossy. The API also sends an
+ * exact base-10 `techniques_bitmask` string: read it into a `bigint`, and send
+ * it back as a string. Built on sudojo_types' techniqueBitmaskOf /
+ * parseTechniqueBitmask / formatTechniqueBitmask.
+ */
+import { type TechniqueBitmaskSource } from '@sudobility/sudojo_types';
+/**
+ * The exact bitmask of a board, daily, validate result or game meta.
+ *
+ * Unlike `techniqueBitmaskOf`, this never throws, because it runs inside page
+ * effects: a malformed `techniques_bitmask` falls back to the numeric field,
+ * and an invalid number falls back to `0n`.
+ */
+export declare function exactTechniqueBitmask(source: TechniqueBitmaskSource | null | undefined): bigint;
+/** The exact bitmask as the base-10 string that API requests take. */
+export declare function techniqueBitmaskString(source: TechniqueBitmaskSource | null | undefined): string;
+/**
+ * The `techniques` / `techniques_bitmask` pair to copy onto game meta
+ * (CurrentGameMeta) or a resumed Board/Daily. Keeps the (lossy) number and adds
+ * the exact string, upgrading legacy meta that only has the number. Both are
+ * null when the source carries no bitmask.
+ */
+export declare function techniqueFieldsOf(source: TechniqueBitmaskSource | null | undefined): {
+    techniques: number | null;
+    techniques_bitmask: string | null;
+};
+//# sourceMappingURL=techniqueBitmask.d.ts.map

package/dist/utils/techniqueBitmask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"techniqueBitmask.d.ts","sourceRoot":"","sources":["../../src/utils/techniqueBitmask.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAC;AAElC;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,CAWR;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAChD;IACD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAWA"}

package/dist/utils/techniqueBitmask.js

@@ -0,0 +1,53 @@
+/**
+ * Exact technique bitmasks for game pages.
+ *
+ * Bit N = technique id N (1-60). A mask with any id >= 54 set exceeds 2^53, so
+ * the numeric `techniques` field from the API is lossy. The API also sends an
+ * exact base-10 `techniques_bitmask` string: read it into a `bigint`, and send
+ * it back as a string. Built on sudojo_types' techniqueBitmaskOf /
+ * parseTechniqueBitmask / formatTechniqueBitmask.
+ */
+import { formatTechniqueBitmask, parseTechniqueBitmask, techniqueBitmaskOf, } from '@sudobility/sudojo_types';
+/**
+ * The exact bitmask of a board, daily, validate result or game meta.
+ *
+ * Unlike `techniqueBitmaskOf`, this never throws, because it runs inside page
+ * effects: a malformed `techniques_bitmask` falls back to the numeric field,
+ * and an invalid number falls back to `0n`.
+ */
+export function exactTechniqueBitmask(source) {
+    if (!source)
+        return 0n;
+    try {
+        return techniqueBitmaskOf(source);
+    }
+    catch {
+        try {
+            return parseTechniqueBitmask(source.techniques);
+        }
+        catch {
+            return 0n;
+        }
+    }
+}
+/** The exact bitmask as the base-10 string that API requests take. */
+export function techniqueBitmaskString(source) {
+    return formatTechniqueBitmask(exactTechniqueBitmask(source));
+}
+/**
+ * The `techniques` / `techniques_bitmask` pair to copy onto game meta
+ * (CurrentGameMeta) or a resumed Board/Daily. Keeps the (lossy) number and adds
+ * the exact string, upgrading legacy meta that only has the number. Both are
+ * null when the source carries no bitmask.
+ */
+export function techniqueFieldsOf(source) {
+    if (!source ||
+        (source.techniques == null && source.techniques_bitmask == null)) {
+        return { techniques: null, techniques_bitmask: null };
+    }
+    return {
+        techniques: source.techniques ?? null,
+        techniques_bitmask: techniqueBitmaskString(source),
+    };
+}
+//# sourceMappingURL=techniqueBitmask.js.map

package/dist/utils/techniqueBitmask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"techniqueBitmask.js","sourceRoot":"","sources":["../../src/utils/techniqueBitmask.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,GAEnB,MAAM,0BAA0B,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAiD;IAEjD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,OAAO,qBAAqB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,sBAAsB,CACpC,MAAiD;IAEjD,OAAO,sBAAsB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAiD;IAKjD,IACE,CAAC,MAAM;QACP,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,IAAI,MAAM,CAAC,kBAAkB,IAAI,IAAI,CAAC,EAChE,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACxD,CAAC;IACD,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;QACrC,kBAAkB,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACnD,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Exact technique bitmasks for game pages.\n *\n * Bit N = technique id N (1-60). A mask with any id >= 54 set exceeds 2^53, so\n * the numeric `techniques` field from the API is lossy. The API also sends an\n * exact base-10 `techniques_bitmask` string: read it into a `bigint`, and send\n * it back as a string. Built on sudojo_types' techniqueBitmaskOf /\n * parseTechniqueBitmask / formatTechniqueBitmask.\n */\n\nimport {\n  formatTechniqueBitmask,\n  parseTechniqueBitmask,\n  techniqueBitmaskOf,\n  type TechniqueBitmaskSource,\n} from '@sudobility/sudojo_types';\n\n/**\n * The exact bitmask of a board, daily, validate result or game meta.\n *\n * Unlike `techniqueBitmaskOf`, this never throws, because it runs inside page\n * effects: a malformed `techniques_bitmask` falls back to the numeric field,\n * and an invalid number falls back to `0n`.\n */\nexport function exactTechniqueBitmask(\n  source: TechniqueBitmaskSource | null | undefined\n): bigint {\n  if (!source) return 0n;\n  try {\n    return techniqueBitmaskOf(source);\n  } catch {\n    try {\n      return parseTechniqueBitmask(source.techniques);\n    } catch {\n      return 0n;\n    }\n  }\n}\n\n/** The exact bitmask as the base-10 string that API requests take. */\nexport function techniqueBitmaskString(\n  source: TechniqueBitmaskSource | null | undefined\n): string {\n  return formatTechniqueBitmask(exactTechniqueBitmask(source));\n}\n\n/**\n * The `techniques` / `techniques_bitmask` pair to copy onto game meta\n * (CurrentGameMeta) or a resumed Board/Daily. Keeps the (lossy) number and adds\n * the exact string, upgrading legacy meta that only has the number. Both are\n * null when the source carries no bitmask.\n */\nexport function techniqueFieldsOf(\n  source: TechniqueBitmaskSource | null | undefined\n): {\n  techniques: number | null;\n  techniques_bitmask: string | null;\n} {\n  if (\n    !source ||\n    (source.techniques == null && source.techniques_bitmask == null)\n  ) {\n    return { techniques: null, techniques_bitmask: null };\n  }\n  return {\n    techniques: source.techniques ?? null,\n    techniques_bitmask: techniqueBitmaskString(source),\n  };\n}\n"]}

package/dist/utils/techniqueExample.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Technique example walkthrough: turn a stored example/practice (board,
+ * pencilmarks, solution, hint_data) into the cards the technique screens
+ * render (web and RN TechniqueExample).
+ */
+import type { WalkthroughStep } from './techniqueWalkthrough';
+import { type TranslateFunction } from './localizedHint';
+/** The stored puzzle a walkthrough is built from (example or practice). */
+export interface TechniqueExampleSource {
+    board: string;
+    pencilmarks: string | null;
+    solution: string;
+    hint_data: string | null;
+}
+/** Translation functions a walkthrough needs (i18next `t`s). */
+export interface TechniqueWalkthroughTranslations {
+    /** The 'hints' namespace */
+    tHints: TranslateFunction;
+    /** The 'techniques' namespace */
+    tTechniques: TranslateFunction;
+    /** The default namespace */
+    tCommon: TranslateFunction;
+}
+/** A built walkthrough: one card per step, each with its heading. */
+export interface TechniqueWalkthrough {
+    /** Cards: starting board, one per solver step, final result */
+    steps: WalkthroughStep[];
+    /**
+     * Heading per card ('' = none): 'Starting position' for the first card,
+     * 'Result' for the last, the step's `headings.<path>` otherwise.
+     */
+    stepHeadings: string[];
+}
+/**
+ * Build the walkthrough cards and headings for a stored example.
+ *
+ * The "Look for {technique}" name comes from the technique's own title when a
+ * path is given (falling back to the first step's title), else the first
+ * step's localized title (RN's rule; the web used the raw title there).
+ */
+export declare function buildTechniqueWalkthrough(source: TechniqueExampleSource | null | undefined, translations: TechniqueWalkthroughTranslations, techniquePath?: string): TechniqueWalkthrough;
+//# sourceMappingURL=techniqueExample.d.ts.map

package/dist/utils/techniqueExample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"techniqueExample.d.ts","sourceRoot":"","sources":["../../src/utils/techniqueExample.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,gEAAgE;AAChE,MAAM,WAAW,gCAAgC;IAC/C,4BAA4B;IAC5B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,iCAAiC;IACjC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,4BAA4B;IAC5B,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB;;;OAGG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,EACjD,YAAY,EAAE,gCAAgC,EAC9C,aAAa,CAAC,EAAE,MAAM,GACrB,oBAAoB,CAwDtB"}

package/dist/utils/techniqueExample.js

@@ -0,0 +1,57 @@
+/**
+ * Technique example walkthrough: turn a stored example/practice (board,
+ * pencilmarks, solution, hint_data) into the cards the technique screens
+ * render (web and RN TechniqueExample).
+ */
+import { buildWalkthroughSteps, parseHintData, parsePracticeBoard, } from './techniqueWalkthrough';
+import { createNamespacedTranslate } from './entityTranslate';
+import { getLocalizedHintTitle, getStepHeadingLocalization, localizedField, } from './localizedHint';
+/**
+ * Build the walkthrough cards and headings for a stored example.
+ *
+ * The "Look for {technique}" name comes from the technique's own title when a
+ * path is given (falling back to the first step's title), else the first
+ * step's localized title (RN's rule; the web used the raw title there).
+ */
+export function buildTechniqueWalkthrough(source, translations, techniquePath) {
+    if (!source)
+        return { steps: [], stepHeadings: [] };
+    const { tHints, tTechniques, tCommon } = translations;
+    // localizeHintStep asks tCommon for 'techniques.<path>.title'; route that
+    // prefix to the techniques namespace, as the apps' tMerged did.
+    const tMerged = createNamespacedTranslate(tCommon, {
+        techniques: tTechniques,
+    });
+    const initialBoard = parsePracticeBoard(source.board, source.pencilmarks, source.solution);
+    const hintData = parseHintData(source.hint_data);
+    const firstStep = hintData?.steps?.[0];
+    const techniqueName = techniquePath
+        ? tTechniques(`${techniquePath}.title`, {
+            defaultValue: firstStep?.title || 'technique',
+        })
+        : firstStep
+            ? getLocalizedHintTitle(tMerged, firstStep)
+            : tTechniques('technique', { defaultValue: 'technique' });
+    const lookForText = tTechniques('lookFor', { technique: techniqueName });
+    const resultText = tTechniques('resultAfterApplying', {
+        defaultValue: 'Result after applying the technique.',
+    });
+    const steps = buildWalkthroughSteps(initialBoard, hintData, lookForText, resultText, tHints, tMerged, techniquePath);
+    const last = steps.length - 1;
+    const stepHeadings = steps.map((step, index) => {
+        if (index === 0) {
+            return tTechniques('walkthroughStartHeading', {
+                defaultValue: 'Starting position',
+            });
+        }
+        if (index === last) {
+            return tTechniques('walkthroughResultHeading', {
+                defaultValue: 'Result',
+            });
+        }
+        const loc = getStepHeadingLocalization(step.hint);
+        return loc ? localizedField(tHints, loc, '') : '';
+    });
+    return { steps, stepHeadings };
+}
+//# sourceMappingURL=techniqueExample.js.map

package/dist/utils/techniqueExample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"techniqueExample.js","sourceRoot":"","sources":["../../src/utils/techniqueExample.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,GAEf,MAAM,iBAAiB,CAAC;AA+BzB;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAiD,EACjD,YAA8C,EAC9C,aAAsB;IAEtB,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IACpD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC;IACtD,0EAA0E;IAC1E,gEAAgE;IAChE,MAAM,OAAO,GAAG,yBAAyB,CAAC,OAAO,EAAE;QACjD,UAAU,EAAE,WAAW;KACxB,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,kBAAkB,CACrC,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,QAAQ,CAChB,CAAC;IACF,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAEvC,MAAM,aAAa,GAAG,aAAa;QACjC,CAAC,CAAC,WAAW,CAAC,GAAG,aAAa,QAAQ,EAAE;YACpC,YAAY,EAAE,SAAS,EAAE,KAAK,IAAI,WAAW;SAC9C,CAAC;QACJ,CAAC,CAAC,SAAS;YACT,CAAC,CAAC,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC;YAC3C,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,WAAW,CAAC,qBAAqB,EAAE;QACpD,YAAY,EAAE,sCAAsC;KACrD,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,qBAAqB,CACjC,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,MAAM,EACN,OAAO,EACP,aAAa,CACd,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC7C,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC,yBAAyB,EAAE;gBAC5C,YAAY,EAAE,mBAAmB;aAClC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,WAAW,CAAC,0BAA0B,EAAE;gBAC7C,YAAY,EAAE,QAAQ;aACvB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,GAAG,GAAG,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AACjC,CAAC","sourcesContent":["/**\n * Technique example walkthrough: turn a stored example/practice (board,\n * pencilmarks, solution, hint_data) into the cards the technique screens\n * render (web and RN TechniqueExample).\n */\n\nimport type { WalkthroughStep } from './techniqueWalkthrough';\nimport {\n  buildWalkthroughSteps,\n  parseHintData,\n  parsePracticeBoard,\n} from './techniqueWalkthrough';\nimport { createNamespacedTranslate } from './entityTranslate';\nimport {\n  getLocalizedHintTitle,\n  getStepHeadingLocalization,\n  localizedField,\n  type TranslateFunction,\n} from './localizedHint';\n\n/** The stored puzzle a walkthrough is built from (example or practice). */\nexport interface TechniqueExampleSource {\n  board: string;\n  pencilmarks: string | null;\n  solution: string;\n  hint_data: string | null;\n}\n\n/** Translation functions a walkthrough needs (i18next `t`s). */\nexport interface TechniqueWalkthroughTranslations {\n  /** The 'hints' namespace */\n  tHints: TranslateFunction;\n  /** The 'techniques' namespace */\n  tTechniques: TranslateFunction;\n  /** The default namespace */\n  tCommon: TranslateFunction;\n}\n\n/** A built walkthrough: one card per step, each with its heading. */\nexport interface TechniqueWalkthrough {\n  /** Cards: starting board, one per solver step, final result */\n  steps: WalkthroughStep[];\n  /**\n   * Heading per card ('' = none): 'Starting position' for the first card,\n   * 'Result' for the last, the step's `headings.<path>` otherwise.\n   */\n  stepHeadings: string[];\n}\n\n/**\n * Build the walkthrough cards and headings for a stored example.\n *\n * The \"Look for {technique}\" name comes from the technique's own title when a\n * path is given (falling back to the first step's title), else the first\n * step's localized title (RN's rule; the web used the raw title there).\n */\nexport function buildTechniqueWalkthrough(\n  source: TechniqueExampleSource | null | undefined,\n  translations: TechniqueWalkthroughTranslations,\n  techniquePath?: string\n): TechniqueWalkthrough {\n  if (!source) return { steps: [], stepHeadings: [] };\n  const { tHints, tTechniques, tCommon } = translations;\n  // localizeHintStep asks tCommon for 'techniques.<path>.title'; route that\n  // prefix to the techniques namespace, as the apps' tMerged did.\n  const tMerged = createNamespacedTranslate(tCommon, {\n    techniques: tTechniques,\n  });\n\n  const initialBoard = parsePracticeBoard(\n    source.board,\n    source.pencilmarks,\n    source.solution\n  );\n  const hintData = parseHintData(source.hint_data);\n  const firstStep = hintData?.steps?.[0];\n\n  const techniqueName = techniquePath\n    ? tTechniques(`${techniquePath}.title`, {\n        defaultValue: firstStep?.title || 'technique',\n      })\n    : firstStep\n      ? getLocalizedHintTitle(tMerged, firstStep)\n      : tTechniques('technique', { defaultValue: 'technique' });\n  const lookForText = tTechniques('lookFor', { technique: techniqueName });\n  const resultText = tTechniques('resultAfterApplying', {\n    defaultValue: 'Result after applying the technique.',\n  });\n\n  const steps = buildWalkthroughSteps(\n    initialBoard,\n    hintData,\n    lookForText,\n    resultText,\n    tHints,\n    tMerged,\n    techniquePath\n  );\n\n  const last = steps.length - 1;\n  const stepHeadings = steps.map((step, index) => {\n    if (index === 0) {\n      return tTechniques('walkthroughStartHeading', {\n        defaultValue: 'Starting position',\n      });\n    }\n    if (index === last) {\n      return tTechniques('walkthroughResultHeading', {\n        defaultValue: 'Result',\n      });\n    }\n    const loc = getStepHeadingLocalization(step.hint);\n    return loc ? localizedField(tHints, loc, '') : '';\n  });\n\n  return { steps, stepHeadings };\n}\n"]}

package/dist/utils/theme.d.ts

@@ -7,6 +7,8 @@ export type ThemePreference = 'light' | 'dark' | 'system';
 export type ResolvedTheme = 'light' | 'dark';
 /** Storage key for theme preference */
 export declare const THEME_STORAGE_KEY = "sudojo-theme";
+/** Storage key for the font size preference (the web ThemeProvider's `fontSizeStorageKey`) */
+export declare const FONT_SIZE_STORAGE_KEY = "sudojo-font-size";
 /**
  * Detect system color scheme preference
  *

package/dist/utils/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/utils/theme.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8BAA8B;AAC9B,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C,uCAAuC;AACvC,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,aAAa,CAK9C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,eAAe,EAC3B,WAAW,EAAE,aAAa,GACzB,aAAa,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,eAAe,CAE1B"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/utils/theme.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8BAA8B;AAC9B,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C,uCAAuC;AACvC,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,aAAa,CAK9C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,eAAe,EAC3B,WAAW,EAAE,aAAa,GACzB,aAAa,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,eAAe,CAE1B"}

package/dist/utils/theme.js

@@ -3,6 +3,8 @@
  */
 /** Storage key for theme preference */
 export const THEME_STORAGE_KEY = 'sudojo-theme';
+/** Storage key for the font size preference (the web ThemeProvider's `fontSizeStorageKey`) */
+export const FONT_SIZE_STORAGE_KEY = 'sudojo-font-size';
 /**
  * Detect system color scheme preference
  *

package/dist/utils/theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/utils/theme.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,uCAAuC;AACvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,OAAO,CAAC;IAClD,OAAO,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,OAAO;QAC9D,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,UAA2B,EAC3B,WAA0B;IAE1B,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAc;IAEd,OAAO,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ,CAAC;AACrE,CAAC","sourcesContent":["/**\n * Theme utilities\n */\n\n/** Available theme options */\nexport type ThemePreference = 'light' | 'dark' | 'system';\n\n/** Resolved theme (without system option) */\nexport type ResolvedTheme = 'light' | 'dark';\n\n/** Storage key for theme preference */\nexport const THEME_STORAGE_KEY = 'sudojo-theme';\n\n/**\n * Detect system color scheme preference\n *\n * @returns 'dark' if system prefers dark mode, 'light' otherwise\n */\nexport function getSystemTheme(): ResolvedTheme {\n  if (typeof window === 'undefined') return 'light';\n  return window.matchMedia('(prefers-color-scheme: dark)').matches\n    ? 'dark'\n    : 'light';\n}\n\n/**\n * Resolve theme preference to actual theme\n *\n * @param preference - User's theme preference\n * @param systemTheme - Current system theme\n * @returns Resolved theme ('light' or 'dark')\n */\nexport function resolveTheme(\n  preference: ThemePreference,\n  systemTheme: ResolvedTheme\n): ResolvedTheme {\n  if (preference === 'system') {\n    return systemTheme;\n  }\n  return preference;\n}\n\n/**\n * Check if a value is a valid theme preference\n *\n * @param value - Value to check\n * @returns Whether value is a valid theme preference\n */\nexport function isValidThemePreference(\n  value: unknown\n): value is ThemePreference {\n  return value === 'light' || value === 'dark' || value === 'system';\n}\n"]}
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/utils/theme.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,uCAAuC;AACvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,OAAO,CAAC;IAClD,OAAO,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,OAAO;QAC9D,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,UAA2B,EAC3B,WAA0B;IAE1B,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAc;IAEd,OAAO,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ,CAAC;AACrE,CAAC","sourcesContent":["/**\n * Theme utilities\n */\n\n/** Available theme options */\nexport type ThemePreference = 'light' | 'dark' | 'system';\n\n/** Resolved theme (without system option) */\nexport type ResolvedTheme = 'light' | 'dark';\n\n/** Storage key for theme preference */\nexport const THEME_STORAGE_KEY = 'sudojo-theme';\n\n/** Storage key for the font size preference (the web ThemeProvider's `fontSizeStorageKey`) */\nexport const FONT_SIZE_STORAGE_KEY = 'sudojo-font-size';\n\n/**\n * Detect system color scheme preference\n *\n * @returns 'dark' if system prefers dark mode, 'light' otherwise\n */\nexport function getSystemTheme(): ResolvedTheme {\n  if (typeof window === 'undefined') return 'light';\n  return window.matchMedia('(prefers-color-scheme: dark)').matches\n    ? 'dark'\n    : 'light';\n}\n\n/**\n * Resolve theme preference to actual theme\n *\n * @param preference - User's theme preference\n * @param systemTheme - Current system theme\n * @returns Resolved theme ('light' or 'dark')\n */\nexport function resolveTheme(\n  preference: ThemePreference,\n  systemTheme: ResolvedTheme\n): ResolvedTheme {\n  if (preference === 'system') {\n    return systemTheme;\n  }\n  return preference;\n}\n\n/**\n * Check if a value is a valid theme preference\n *\n * @param value - Value to check\n * @returns Whether value is a valid theme preference\n */\nexport function isValidThemePreference(\n  value: unknown\n): value is ThemePreference {\n  return value === 'light' || value === 'dark' || value === 'system';\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/sudojo_lib",
-  "version": "0.0.201",
+  "version": "0.0.203",
   "description": "Business logic library for Sudojo app",
   "type": "module",
   "main": "dist/index.js",
@@ -29,8 +29,8 @@
     "test:watch": "vitest --watch",
     "lint": "eslint src --ext .ts,.tsx",
     "lint:fix": "eslint src --ext .ts,.tsx --fix",
-    "format": "prettier --write src/**/*.ts",
-    "format:check": "prettier --check src/**/*.ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
     "typecheck": "tsc --noEmit",
     "typecheck:watch": "tsc --noEmit --watch",
     "check-all": "bun run lint && bun run typecheck && bun run test:unit",
@@ -47,8 +47,8 @@
   "license": "BUSL-1.1",
   "devDependencies": {
     "@sudobility/di": "^1.5.68",
-    "@sudobility/sudojo_client": "^0.0.160",
-    "@sudobility/sudojo_types": "^1.2.71",
+    "@sudobility/sudojo_client": "^0.0.162",
+    "@sudobility/sudojo_types": "^1.2.72",
     "@sudobility/types": "^1.9.68",
     "@tanstack/react-query": "^5.90.11",
     "@testing-library/dom": "^10.4.1",
@@ -73,8 +73,8 @@
   },
   "peerDependencies": {
     "@sudobility/di": "^1.5.68",
-    "@sudobility/sudojo_client": "^0.0.160",
-    "@sudobility/sudojo_types": "^1.2.71",
+    "@sudobility/sudojo_client": "^0.0.162",
+    "@sudobility/sudojo_types": "^1.2.72",
     "@sudobility/types": "^1.9.68",
     "@tanstack/react-query": ">=5.0.0",
     "react": ">=18.0.0",