@intellectif/lk-react 23.1.0 → 23.1.2

package/dist/direction-K1pj0HCA.cjs

@@ -0,0 +1,200 @@
+'use client';
+//#region src/i18n/direction.ts
+/**
+* The writing direction of authored content. A language tag is read from the
+* tag alone, so a server rendering and the browser that hydrates it agree on
+* it. Text is read by the runtime's Unicode tables, which agree on every
+* character both runtimes' Unicode versions know.
+*/
+/** ISO 15924 codes of the scripts written right to left. */
+const RTL_SCRIPT_CODES = /* @__PURE__ */ new Set([
+	"phlv",
+	"adlm",
+	"arab",
+	"aran",
+	"armi",
+	"avst",
+	"chrs",
+	"cprt",
+	"elym",
+	"gara",
+	"hatr",
+	"hebr",
+	"hung",
+	"khar",
+	"lydi",
+	"mand",
+	"mani",
+	"mend",
+	"merc",
+	"mero",
+	"narb",
+	"nbat",
+	"nkoo",
+	"orkh",
+	"ougr",
+	"palm",
+	"phli",
+	"phlp",
+	"phnx",
+	"prti",
+	"rohg",
+	"samr",
+	"sarb",
+	"sidt",
+	"sogd",
+	"sogo",
+	"syrc",
+	"syre",
+	"syrj",
+	"syrn",
+	"thaa",
+	"yezi"
+]);
+/**
+* Languages written right to left in every script they are commonly written
+* in, including the deprecated tags `iw` and `ji` and the Arabic varieties
+* with tags of their own. A language also written left to right — Kurdish,
+* Sindhi, Uyghur — is not listed: its own text decides.
+*/
+const RTL_LANGUAGES = /* @__PURE__ */ new Set([
+	"acm",
+	"aeb",
+	"aii",
+	"ajp",
+	"apc",
+	"ar",
+	"arc",
+	"ars",
+	"ary",
+	"arz",
+	"azb",
+	"bqi",
+	"ckb",
+	"dv",
+	"fa",
+	"glk",
+	"hbo",
+	"he",
+	"iw",
+	"ji",
+	"jrb",
+	"khw",
+	"lrc",
+	"mzn",
+	"nqo",
+	"ota",
+	"pnb",
+	"prs",
+	"ps",
+	"sdh",
+	"skr",
+	"syc",
+	"syr",
+	"ur",
+	"yi"
+]);
+/**
+* The code-point blocks Unicode reserves for right-to-left scripts (their
+* default bidirectional class is R or AL): Hebrew through Arabic Extended-A,
+* the Hebrew and Arabic presentation forms, the historic right-to-left scripts
+* of the Supplementary Multilingual Plane, and Mende Kikakui through the Arabic
+* mathematical letters. A letter in one of them is written right to left.
+*/
+const RTL_BLOCKS = [
+	[1424, 2303],
+	[64285, 65023],
+	[65136, 65279],
+	[67584, 69631],
+	[124928, 126975]
+];
+/** Digits whose bidirectional class is R: N'Ko, Mende Kikakui and Adlam. */
+const RTL_DIGITS = [
+	[1984, 1993],
+	[125127, 125135],
+	[125264, 125273]
+];
+const LETTER_RE = /^\p{L}$/u;
+const NUMBER_RE = /^\p{N}$/u;
+function within(point, ranges) {
+	return ranges.some(([first, last]) => point >= first && point <= last);
+}
+/**
+* The script subtag of a BCP 47 tag's lowercased subtags, if it names a
+* direction: not in a private-use or grandfathered tag (`x-arab`, `i-klingon`),
+* and not one of the codes for no particular script — Common, Inherited,
+* Unwritten, Unknown and the like (`Z` codes) or private use (`Qaaa`–`Qabx`).
+*/
+function scriptSubtagOf(subtags) {
+	if (subtags[0].length === 1) return;
+	let index = 1;
+	while (index < subtags.length && index <= 3 && /^[a-z]{3}$/.test(subtags[index])) index += 1;
+	const candidate = subtags[index];
+	if (candidate === void 0 || !/^[a-z]{4}$/.test(candidate)) return;
+	return /^z/.test(candidate) || candidate >= "qaaa" && candidate <= "qabx" ? void 0 : candidate;
+}
+/**
+* The direction a language tag names, or `undefined` when it names none: its
+* script subtag when it has one (`ku-Arab` is right-to-left, `ar-Latn` is not),
+* then the languages above. `-` and `_` both separate subtags. Anything that is
+* not a string names none.
+*/
+function localeDirectionOf(locale) {
+	if (typeof locale !== "string") return;
+	const subtags = locale.toLowerCase().split(/[-_]/);
+	const script = scriptSubtagOf(subtags);
+	if (script !== void 0) return RTL_SCRIPT_CODES.has(script) ? "rtl" : "ltr";
+	return RTL_LANGUAGES.has(subtags[0]) ? "rtl" : void 0;
+}
+const LEFT_TO_RIGHT_MARK = String.fromCodePoint(8206);
+/** RIGHT-TO-LEFT MARK and ARABIC LETTER MARK. */
+const RIGHT_TO_LEFT_MARKS = /* @__PURE__ */ new Set([String.fromCodePoint(8207), String.fromCodePoint(1564)]);
+/**
+* The direction of `text`'s first letter or directional mark — an author can
+* start a transcript with a right-to-left mark to lay it out right to left — or
+* `undefined` when it has neither. Other characters with a strong direction,
+* such as a Hebrew punctuation mark or an N'Ko digit, are not read, so this is
+* the first strong character the Unicode bidirectional algorithm finds only
+* where the text starts with a letter or a mark. Letters are read by the
+* runtime's Unicode tables: a letter added in a later Unicode version than a
+* server's is not one to that server.
+*/
+function textDirectionOf(text) {
+	for (const character of text) {
+		if (character === LEFT_TO_RIGHT_MARK) return "ltr";
+		if (RIGHT_TO_LEFT_MARKS.has(character)) return "rtl";
+		if (LETTER_RE.test(character)) return within(character.codePointAt(0), RTL_BLOCKS) ? "rtl" : "ltr";
+	}
+}
+/**
+* The direction a single character is laid out in, for a mark standing in for
+* it: a digit runs left to right unless it is one of the right-to-left digits,
+* a letter runs in its script's direction, and anything else has none of its
+* own.
+*/
+function characterDirectionOf(character) {
+	const point = character.codePointAt(0);
+	if (NUMBER_RE.test(character)) return within(point, RTL_DIGITS) ? "rtl" : "ltr";
+	if (LETTER_RE.test(character)) return within(point, RTL_BLOCKS) ? "rtl" : "ltr";
+}
+//#endregion
+Object.defineProperty(exports, "characterDirectionOf", {
+	enumerable: true,
+	get: function() {
+		return characterDirectionOf;
+	}
+});
+Object.defineProperty(exports, "localeDirectionOf", {
+	enumerable: true,
+	get: function() {
+		return localeDirectionOf;
+	}
+});
+Object.defineProperty(exports, "textDirectionOf", {
+	enumerable: true,
+	get: function() {
+		return textDirectionOf;
+	}
+});
+
+//# sourceMappingURL=direction-K1pj0HCA.cjs.map

package/dist/direction-K1pj0HCA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"direction-K1pj0HCA.cjs","names":[],"sources":["../src/i18n/direction.ts"],"sourcesContent":["/**\n * The writing direction of authored content. A language tag is read from the\n * tag alone, so a server rendering and the browser that hydrates it agree on\n * it. Text is read by the runtime's Unicode tables, which agree on every\n * character both runtimes' Unicode versions know.\n */\n\n/** ISO 15924 codes of the scripts written right to left. */\nconst RTL_SCRIPT_CODES = new Set([\n  'phlv',\n  'adlm',\n  'arab',\n  'aran',\n  'armi',\n  'avst',\n  'chrs',\n  'cprt',\n  'elym',\n  'gara',\n  'hatr',\n  'hebr',\n  'hung',\n  'khar',\n  'lydi',\n  'mand',\n  'mani',\n  'mend',\n  'merc',\n  'mero',\n  'narb',\n  'nbat',\n  'nkoo',\n  'orkh',\n  'ougr',\n  'palm',\n  'phli',\n  'phlp',\n  'phnx',\n  'prti',\n  'rohg',\n  'samr',\n  'sarb',\n  'sidt',\n  'sogd',\n  'sogo',\n  'syrc',\n  'syre',\n  'syrj',\n  'syrn',\n  'thaa',\n  'yezi',\n]);\n\n/**\n * Languages written right to left in every script they are commonly written\n * in, including the deprecated tags `iw` and `ji` and the Arabic varieties\n * with tags of their own. A language also written left to right — Kurdish,\n * Sindhi, Uyghur — is not listed: its own text decides.\n */\nconst RTL_LANGUAGES = new Set([\n  'acm',\n  'aeb',\n  'aii',\n  'ajp',\n  'apc',\n  'ar',\n  'arc',\n  'ars',\n  'ary',\n  'arz',\n  'azb',\n  'bqi',\n  'ckb',\n  'dv',\n  'fa',\n  'glk',\n  'hbo',\n  'he',\n  'iw',\n  'ji',\n  'jrb',\n  'khw',\n  'lrc',\n  'mzn',\n  'nqo',\n  'ota',\n  'pnb',\n  'prs',\n  'ps',\n  'sdh',\n  'skr',\n  'syc',\n  'syr',\n  'ur',\n  'yi',\n]);\n\n/**\n * The code-point blocks Unicode reserves for right-to-left scripts (their\n * default bidirectional class is R or AL): Hebrew through Arabic Extended-A,\n * the Hebrew and Arabic presentation forms, the historic right-to-left scripts\n * of the Supplementary Multilingual Plane, and Mende Kikakui through the Arabic\n * mathematical letters. A letter in one of them is written right to left.\n */\nconst RTL_BLOCKS: readonly (readonly [number, number])[] = [\n  [0x0590, 0x08ff],\n  [0xfb1d, 0xfdff],\n  [0xfe70, 0xfeff],\n  [0x10800, 0x10fff],\n  [0x1e800, 0x1efff],\n];\n\n/** Digits whose bidirectional class is R: N'Ko, Mende Kikakui and Adlam. */\nconst RTL_DIGITS: readonly (readonly [number, number])[] = [\n  [0x07c0, 0x07c9],\n  [0x1e8c7, 0x1e8cf],\n  [0x1e950, 0x1e959],\n];\n\nconst LETTER_RE = /^\\p{L}$/u;\nconst NUMBER_RE = /^\\p{N}$/u;\n\nfunction within(point: number, ranges: readonly (readonly [number, number])[]): boolean {\n  return ranges.some(([first, last]) => point >= first && point <= last);\n}\n\n/**\n * The script subtag of a BCP 47 tag's lowercased subtags, if it names a\n * direction: not in a private-use or grandfathered tag (`x-arab`, `i-klingon`),\n * and not one of the codes for no particular script — Common, Inherited,\n * Unwritten, Unknown and the like (`Z` codes) or private use (`Qaaa`–`Qabx`).\n */\nfunction scriptSubtagOf(subtags: readonly string[]): string | undefined {\n  if ((subtags[0] as string).length === 1) {\n    return undefined;\n  }\n  let index = 1;\n  // Up to three extended language subtags may come between language and script.\n  while (index < subtags.length && index <= 3 && /^[a-z]{3}$/.test(subtags[index] as string)) {\n    index += 1;\n  }\n  const candidate = subtags[index];\n  if (candidate === undefined || !/^[a-z]{4}$/.test(candidate)) {\n    return undefined;\n  }\n  return /^z/.test(candidate) || (candidate >= 'qaaa' && candidate <= 'qabx')\n    ? undefined\n    : candidate;\n}\n\n/**\n * The direction a language tag names, or `undefined` when it names none: its\n * script subtag when it has one (`ku-Arab` is right-to-left, `ar-Latn` is not),\n * then the languages above. `-` and `_` both separate subtags. Anything that is\n * not a string names none.\n */\nexport function localeDirectionOf(locale: unknown): 'ltr' | 'rtl' | undefined {\n  if (typeof locale !== 'string') {\n    return undefined;\n  }\n  const subtags = locale.toLowerCase().split(/[-_]/);\n  const script = scriptSubtagOf(subtags);\n  if (script !== undefined) {\n    return RTL_SCRIPT_CODES.has(script) ? 'rtl' : 'ltr';\n  }\n  return RTL_LANGUAGES.has(subtags[0] as string) ? 'rtl' : undefined;\n}\n\nconst LEFT_TO_RIGHT_MARK = String.fromCodePoint(0x200e);\n/** RIGHT-TO-LEFT MARK and ARABIC LETTER MARK. */\nconst RIGHT_TO_LEFT_MARKS = new Set([String.fromCodePoint(0x200f), String.fromCodePoint(0x61c)]);\n\n/**\n * The direction of `text`'s first letter or directional mark — an author can\n * start a transcript with a right-to-left mark to lay it out right to left — or\n * `undefined` when it has neither. Other characters with a strong direction,\n * such as a Hebrew punctuation mark or an N'Ko digit, are not read, so this is\n * the first strong character the Unicode bidirectional algorithm finds only\n * where the text starts with a letter or a mark. Letters are read by the\n * runtime's Unicode tables: a letter added in a later Unicode version than a\n * server's is not one to that server.\n */\nexport function textDirectionOf(text: string): 'ltr' | 'rtl' | undefined {\n  for (const character of text) {\n    if (character === LEFT_TO_RIGHT_MARK) {\n      return 'ltr';\n    }\n    if (RIGHT_TO_LEFT_MARKS.has(character)) {\n      return 'rtl';\n    }\n    if (LETTER_RE.test(character)) {\n      return within(character.codePointAt(0) as number, RTL_BLOCKS) ? 'rtl' : 'ltr';\n    }\n  }\n  return undefined;\n}\n\n/**\n * The direction a single character is laid out in, for a mark standing in for\n * it: a digit runs left to right unless it is one of the right-to-left digits,\n * a letter runs in its script's direction, and anything else has none of its\n * own.\n */\nexport function characterDirectionOf(character: string): 'ltr' | 'rtl' | undefined {\n  const point = character.codePointAt(0) as number;\n  if (NUMBER_RE.test(character)) {\n    return within(point, RTL_DIGITS) ? 'rtl' : 'ltr';\n  }\n  if (LETTER_RE.test(character)) {\n    return within(point, RTL_BLOCKS) ? 'rtl' : 'ltr';\n  }\n  return undefined;\n}\n"],"mappings":";;;;;;;;AAQA,MAAM,mCAAmB,IAAI,IAAI;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;AAQD,MAAM,gCAAgB,IAAI,IAAI;CAC5B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;;AASD,MAAM,aAAqD;CACzD,CAAC,MAAQ,IAAM;CACf,CAAC,OAAQ,KAAM;CACf,CAAC,OAAQ,KAAM;CACf,CAAC,OAAS,KAAO;CACjB,CAAC,QAAS,MAAO;AACnB;;AAGA,MAAM,aAAqD;CACzD,CAAC,MAAQ,IAAM;CACf,CAAC,QAAS,MAAO;CACjB,CAAC,QAAS,MAAO;AACnB;AAEA,MAAM,YAAY;AAClB,MAAM,YAAY;AAElB,SAAS,OAAO,OAAe,QAAyD;CACtF,OAAO,OAAO,MAAM,CAAC,OAAO,UAAU,SAAS,SAAS,SAAS,IAAI;AACvE;;;;;;;AAQA,SAAS,eAAe,SAAgD;CACtE,IAAK,QAAQ,EAAE,CAAY,WAAW,GACpC;CAEF,IAAI,QAAQ;CAEZ,OAAO,QAAQ,QAAQ,UAAU,SAAS,KAAK,aAAa,KAAK,QAAQ,MAAgB,GACvF,SAAS;CAEX,MAAM,YAAY,QAAQ;CAC1B,IAAI,cAAc,KAAA,KAAa,CAAC,aAAa,KAAK,SAAS,GACzD;CAEF,OAAO,KAAK,KAAK,SAAS,KAAM,aAAa,UAAU,aAAa,SAChE,KAAA,IACA;AACN;;;;;;;AAQA,SAAgB,kBAAkB,QAA4C;CAC5E,IAAI,OAAO,WAAW,UACpB;CAEF,MAAM,UAAU,OAAO,YAAY,CAAC,CAAC,MAAM,MAAM;CACjD,MAAM,SAAS,eAAe,OAAO;CACrC,IAAI,WAAW,KAAA,GACb,OAAO,iBAAiB,IAAI,MAAM,IAAI,QAAQ;CAEhD,OAAO,cAAc,IAAI,QAAQ,EAAY,IAAI,QAAQ,KAAA;AAC3D;AAEA,MAAM,qBAAqB,OAAO,cAAc,IAAM;;AAEtD,MAAM,sCAAsB,IAAI,IAAI,CAAC,OAAO,cAAc,IAAM,GAAG,OAAO,cAAc,IAAK,CAAC,CAAC;;;;;;;;;;;AAY/F,SAAgB,gBAAgB,MAAyC;CACvE,KAAK,MAAM,aAAa,MAAM;EAC5B,IAAI,cAAc,oBAChB,OAAO;EAET,IAAI,oBAAoB,IAAI,SAAS,GACnC,OAAO;EAET,IAAI,UAAU,KAAK,SAAS,GAC1B,OAAO,OAAO,UAAU,YAAY,CAAC,GAAa,UAAU,IAAI,QAAQ;CAE5E;AAEF;;;;;;;AAQA,SAAgB,qBAAqB,WAA8C;CACjF,MAAM,QAAQ,UAAU,YAAY,CAAC;CACrC,IAAI,UAAU,KAAK,SAAS,GAC1B,OAAO,OAAO,OAAO,UAAU,IAAI,QAAQ;CAE7C,IAAI,UAAU,KAAK,SAAS,GAC1B,OAAO,OAAO,OAAO,UAAU,IAAI,QAAQ;AAG/C"}

package/dist/hooks/useActivityState.cjs

@@ -1,13 +1,31 @@
 'use client';
-'use strict';
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+//#region src/hooks/useActivityState.ts
+/**
+* Tracks an activity's lifecycle state and elapsed time. Timing is held in a
+* ref (no re-render) and `getTimeSpent()` is read imperatively at submission.
+*/
+function useActivityState(initialState = "idle") {
+	const [state, setState] = (0, react.useState)(initialState);
+	const startTimeRef = (0, react.useRef)(null);
+	return {
+		state,
+		start: (0, react.useCallback)(() => {
+			if (startTimeRef.current === null) startTimeRef.current = Date.now();
+			setState((prev) => prev === "idle" ? "in-progress" : prev);
+		}, []),
+		complete: (0, react.useCallback)(() => setState("completed"), []),
+		review: (0, react.useCallback)(() => setState("reviewing"), []),
+		reset: (0, react.useCallback)((to = "idle") => {
+			startTimeRef.current = null;
+			setState(to);
+		}, []),
+		getTimeSpent: (0, react.useCallback)(() => startTimeRef.current === null ? 0 : Date.now() - startTimeRef.current, [])
+	};
+}
+//#endregion
+exports.useActivityState = useActivityState;
 
-var chunkXOR4MPEN_cjs = require('../chunk-XOR4MPEN.cjs');
-
-
-
-Object.defineProperty(exports, "useActivityState", {
-  enumerable: true,
-  get: function () { return chunkXOR4MPEN_cjs.useActivityState; }
-});
-//# sourceMappingURL=useActivityState.cjs.map
 //# sourceMappingURL=useActivityState.cjs.map

package/dist/hooks/useActivityState.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"useActivityState.cjs"}
+{"version":3,"file":"useActivityState.cjs","names":["useState","useRef","useCallback"],"sources":["../../src/hooks/useActivityState.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useRef, useState } from 'react';\n\nexport type ActivityState = 'idle' | 'in-progress' | 'completed' | 'reviewing';\n\nexport interface UseActivityStateResult {\n  state: ActivityState;\n  /** idle → in-progress; records start time once. Idempotent: repeated calls\n   *  (e.g. every learner interaction) neither restart timing nor regress state. */\n  start: () => void;\n  /** → completed. */\n  complete: () => void;\n  /** → reviewing (e.g. when showing correct answers). */\n  review: () => void;\n  /**\n   * Clears timing and returns to `to`, defaulting to `idle`. Call when the\n   * activity `data` prop changes.\n   *\n   * The target is a parameter because \"reset\" for a RESTORED item does not\n   * mean idle: an item the learner had already submitted must come back\n   * submitted, or a data-prop change quietly unlocks committed work.\n   */\n  reset: (to?: ActivityState) => void;\n  /** Elapsed ms since `start()`; 0 when not started (or after `reset()`). */\n  getTimeSpent: () => number;\n}\n\n/**\n * Tracks an activity's lifecycle state and elapsed time. Timing is held in a\n * ref (no re-render) and `getTimeSpent()` is read imperatively at submission.\n */\nexport function useActivityState(initialState: ActivityState = 'idle'): UseActivityStateResult {\n  // `initialState` seeds the MOUNT only, like any `default*` value. It exists\n  // so a resumed attempt can reopen a question the learner had already\n  // submitted as submitted — without it, an exam that locks each question on\n  // submit silently unlocks every one of them after a crash, and the learner\n  // can answer and submit the same question twice.\n  const [state, setState] = useState<ActivityState>(initialState);\n  const startTimeRef = useRef<number | null>(null);\n\n  const start = useCallback(() => {\n    // Ref guard makes timing idempotent without a side effect in the updater\n    // (StrictMode double-invokes updaters); the updater itself stays pure.\n    if (startTimeRef.current === null) {\n      startTimeRef.current = Date.now();\n    }\n    setState((prev) => (prev === 'idle' ? 'in-progress' : prev));\n  }, []);\n\n  const complete = useCallback(() => setState('completed'), []);\n\n  const review = useCallback(() => setState('reviewing'), []);\n\n  const reset = useCallback((to: ActivityState = 'idle') => {\n    startTimeRef.current = null;\n    setState(to);\n  }, []);\n\n  const getTimeSpent = useCallback(\n    () => (startTimeRef.current === null ? 0 : Date.now() - startTimeRef.current),\n    [],\n  );\n\n  return { state, start, complete, review, reset, getTimeSpent };\n}\n"],"mappings":";;;;;;;;AAgCA,SAAgB,iBAAiB,eAA8B,QAAgC;CAM7F,MAAM,CAAC,OAAO,aAAA,GAAYA,MAAAA,SAAAA,CAAwB,YAAY;CAC9D,MAAM,gBAAA,GAAeC,MAAAA,OAAAA,CAAsB,IAAI;CAyB/C,OAAO;EAAE;EAAO,QAAA,GAvBFC,MAAAA,YAAAA,OAAkB;GAG9B,IAAI,aAAa,YAAY,MAC3B,aAAa,UAAU,KAAK,IAAI;GAElC,UAAU,SAAU,SAAS,SAAS,gBAAgB,IAAK;EAC7D,GAAG,CAAC,CAgBgB;EAAG,WAAA,GAdNA,MAAAA,YAAAA,OAAkB,SAAS,WAAW,GAAG,CAAC,CAc7B;EAAG,SAAA,GAZlBA,MAAAA,YAAAA,OAAkB,SAAS,WAAW,GAAG,CAAC,CAYnB;EAAG,QAAA,GAV3BA,MAAAA,YAAAA,EAAa,KAAoB,WAAW;GACxD,aAAa,UAAU;GACvB,SAAS,EAAE;EACb,GAAG,CAAC,CAOyC;EAAG,eAAA,GAL3BA,MAAAA,YAAAA,OACZ,aAAa,YAAY,OAAO,IAAI,KAAK,IAAI,IAAI,aAAa,SACrE,CAAC,CAGwD;CAAE;AAC/D"}

package/dist/hooks/useActivityState.d.cts

@@ -1,29 +1,30 @@
-type ActivityState = 'idle' | 'in-progress' | 'completed' | 'reviewing';
-interface UseActivityStateResult {
-    state: ActivityState;
-    /** idle → in-progress; records start time once. Idempotent: repeated calls
-     *  (e.g. every learner interaction) neither restart timing nor regress state. */
-    start: () => void;
-    /** → completed. */
-    complete: () => void;
-    /** → reviewing (e.g. when showing correct answers). */
-    review: () => void;
-    /**
-     * Clears timing and returns to `to`, defaulting to `idle`. Call when the
-     * activity `data` prop changes.
-     *
-     * The target is a parameter because "reset" for a RESTORED item does not
-     * mean idle: an item the learner had already submitted must come back
-     * submitted, or a data-prop change quietly unlocks committed work.
-     */
-    reset: (to?: ActivityState) => void;
-    /** Elapsed ms since `start()`; 0 when not started (or after `reset()`). */
-    getTimeSpent: () => number;
+//#region src/hooks/useActivityState.d.ts
+export type ActivityState = 'idle' | 'in-progress' | 'completed' | 'reviewing';
+export interface UseActivityStateResult {
+  state: ActivityState;
+  /** idle → in-progress; records start time once. Idempotent: repeated calls
+   *  (e.g. every learner interaction) neither restart timing nor regress state. */
+  start: () => void;
+  /** → completed. */
+  complete: () => void;
+  /** → reviewing (e.g. when showing correct answers). */
+  review: () => void;
+  /**
+   * Clears timing and returns to `to`, defaulting to `idle`. Call when the
+   * activity `data` prop changes.
+   *
+   * The target is a parameter because "reset" for a RESTORED item does not
+   * mean idle: an item the learner had already submitted must come back
+   * submitted, or a data-prop change quietly unlocks committed work.
+   */
+  reset: (to?: ActivityState) => void;
+  /** Elapsed ms since `start()`; 0 when not started (or after `reset()`). */
+  getTimeSpent: () => number;
 }
 /**
  * Tracks an activity's lifecycle state and elapsed time. Timing is held in a
  * ref (no re-render) and `getTimeSpent()` is read imperatively at submission.
  */
-declare function useActivityState(initialState?: ActivityState): UseActivityStateResult;
-
-export { type ActivityState, type UseActivityStateResult, useActivityState };
+export declare function useActivityState(initialState?: ActivityState): UseActivityStateResult;
+//#endregion
+//# sourceMappingURL=useActivityState.d.cts.map

package/dist/hooks/useActivityState.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActivityState.d.cts","names":[],"sources":["../../src/hooks/useActivityState.ts"],"mappings":";YAIY;iBAEK;EACf,OAAO;;;EAGP;;EAEA;;EAEA;;;;;;;;;EASA,QAAQ,KAAK;;EAEb;;;;;;wBAOc,iBAAiB,eAAc,gBAAyB"}

package/dist/hooks/useActivityState.d.ts

@@ -1,29 +1,30 @@
-type ActivityState = 'idle' | 'in-progress' | 'completed' | 'reviewing';
-interface UseActivityStateResult {
-    state: ActivityState;
-    /** idle → in-progress; records start time once. Idempotent: repeated calls
-     *  (e.g. every learner interaction) neither restart timing nor regress state. */
-    start: () => void;
-    /** → completed. */
-    complete: () => void;
-    /** → reviewing (e.g. when showing correct answers). */
-    review: () => void;
-    /**
-     * Clears timing and returns to `to`, defaulting to `idle`. Call when the
-     * activity `data` prop changes.
-     *
-     * The target is a parameter because "reset" for a RESTORED item does not
-     * mean idle: an item the learner had already submitted must come back
-     * submitted, or a data-prop change quietly unlocks committed work.
-     */
-    reset: (to?: ActivityState) => void;
-    /** Elapsed ms since `start()`; 0 when not started (or after `reset()`). */
-    getTimeSpent: () => number;
+//#region src/hooks/useActivityState.d.ts
+export type ActivityState = 'idle' | 'in-progress' | 'completed' | 'reviewing';
+export interface UseActivityStateResult {
+  state: ActivityState;
+  /** idle → in-progress; records start time once. Idempotent: repeated calls
+   *  (e.g. every learner interaction) neither restart timing nor regress state. */
+  start: () => void;
+  /** → completed. */
+  complete: () => void;
+  /** → reviewing (e.g. when showing correct answers). */
+  review: () => void;
+  /**
+   * Clears timing and returns to `to`, defaulting to `idle`. Call when the
+   * activity `data` prop changes.
+   *
+   * The target is a parameter because "reset" for a RESTORED item does not
+   * mean idle: an item the learner had already submitted must come back
+   * submitted, or a data-prop change quietly unlocks committed work.
+   */
+  reset: (to?: ActivityState) => void;
+  /** Elapsed ms since `start()`; 0 when not started (or after `reset()`). */
+  getTimeSpent: () => number;
 }
 /**
  * Tracks an activity's lifecycle state and elapsed time. Timing is held in a
  * ref (no re-render) and `getTimeSpent()` is read imperatively at submission.
  */
-declare function useActivityState(initialState?: ActivityState): UseActivityStateResult;
-
-export { type ActivityState, type UseActivityStateResult, useActivityState };
+export declare function useActivityState(initialState?: ActivityState): UseActivityStateResult;
+//#endregion
+//# sourceMappingURL=useActivityState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useActivityState.d.ts","names":[],"sources":["../../src/hooks/useActivityState.ts"],"mappings":";YAIY;iBAEK;EACf,OAAO;;;EAGP;;EAEA;;EAEA;;;;;;;;;EASA,QAAQ,KAAK;;EAEb;;;;;;wBAOc,iBAAiB,eAAc,gBAAyB"}

package/dist/hooks/useActivityState.js

@@ -1,4 +1,30 @@
 'use client';
-export { useActivityState } from '../chunk-6N43WDVG.js';
-//# sourceMappingURL=useActivityState.js.map
+"use client";
+import { useCallback, useRef, useState } from "react";
+//#region src/hooks/useActivityState.ts
+/**
+* Tracks an activity's lifecycle state and elapsed time. Timing is held in a
+* ref (no re-render) and `getTimeSpent()` is read imperatively at submission.
+*/
+function useActivityState(initialState = "idle") {
+	const [state, setState] = useState(initialState);
+	const startTimeRef = useRef(null);
+	return {
+		state,
+		start: useCallback(() => {
+			if (startTimeRef.current === null) startTimeRef.current = Date.now();
+			setState((prev) => prev === "idle" ? "in-progress" : prev);
+		}, []),
+		complete: useCallback(() => setState("completed"), []),
+		review: useCallback(() => setState("reviewing"), []),
+		reset: useCallback((to = "idle") => {
+			startTimeRef.current = null;
+			setState(to);
+		}, []),
+		getTimeSpent: useCallback(() => startTimeRef.current === null ? 0 : Date.now() - startTimeRef.current, [])
+	};
+}
+//#endregion
+export { useActivityState };
+
 //# sourceMappingURL=useActivityState.js.map

package/dist/hooks/useActivityState.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"useActivityState.js"}
+{"version":3,"file":"useActivityState.js","names":[],"sources":["../../src/hooks/useActivityState.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useRef, useState } from 'react';\n\nexport type ActivityState = 'idle' | 'in-progress' | 'completed' | 'reviewing';\n\nexport interface UseActivityStateResult {\n  state: ActivityState;\n  /** idle → in-progress; records start time once. Idempotent: repeated calls\n   *  (e.g. every learner interaction) neither restart timing nor regress state. */\n  start: () => void;\n  /** → completed. */\n  complete: () => void;\n  /** → reviewing (e.g. when showing correct answers). */\n  review: () => void;\n  /**\n   * Clears timing and returns to `to`, defaulting to `idle`. Call when the\n   * activity `data` prop changes.\n   *\n   * The target is a parameter because \"reset\" for a RESTORED item does not\n   * mean idle: an item the learner had already submitted must come back\n   * submitted, or a data-prop change quietly unlocks committed work.\n   */\n  reset: (to?: ActivityState) => void;\n  /** Elapsed ms since `start()`; 0 when not started (or after `reset()`). */\n  getTimeSpent: () => number;\n}\n\n/**\n * Tracks an activity's lifecycle state and elapsed time. Timing is held in a\n * ref (no re-render) and `getTimeSpent()` is read imperatively at submission.\n */\nexport function useActivityState(initialState: ActivityState = 'idle'): UseActivityStateResult {\n  // `initialState` seeds the MOUNT only, like any `default*` value. It exists\n  // so a resumed attempt can reopen a question the learner had already\n  // submitted as submitted — without it, an exam that locks each question on\n  // submit silently unlocks every one of them after a crash, and the learner\n  // can answer and submit the same question twice.\n  const [state, setState] = useState<ActivityState>(initialState);\n  const startTimeRef = useRef<number | null>(null);\n\n  const start = useCallback(() => {\n    // Ref guard makes timing idempotent without a side effect in the updater\n    // (StrictMode double-invokes updaters); the updater itself stays pure.\n    if (startTimeRef.current === null) {\n      startTimeRef.current = Date.now();\n    }\n    setState((prev) => (prev === 'idle' ? 'in-progress' : prev));\n  }, []);\n\n  const complete = useCallback(() => setState('completed'), []);\n\n  const review = useCallback(() => setState('reviewing'), []);\n\n  const reset = useCallback((to: ActivityState = 'idle') => {\n    startTimeRef.current = null;\n    setState(to);\n  }, []);\n\n  const getTimeSpent = useCallback(\n    () => (startTimeRef.current === null ? 0 : Date.now() - startTimeRef.current),\n    [],\n  );\n\n  return { state, start, complete, review, reset, getTimeSpent };\n}\n"],"mappings":";;;;;;;AAgCA,SAAgB,iBAAiB,eAA8B,QAAgC;CAM7F,MAAM,CAAC,OAAO,YAAY,SAAwB,YAAY;CAC9D,MAAM,eAAe,OAAsB,IAAI;CAyB/C,OAAO;EAAE;EAAO,OAvBF,kBAAkB;GAG9B,IAAI,aAAa,YAAY,MAC3B,aAAa,UAAU,KAAK,IAAI;GAElC,UAAU,SAAU,SAAS,SAAS,gBAAgB,IAAK;EAC7D,GAAG,CAAC,CAgBgB;EAAG,UAdN,kBAAkB,SAAS,WAAW,GAAG,CAAC,CAc7B;EAAG,QAZlB,kBAAkB,SAAS,WAAW,GAAG,CAAC,CAYnB;EAAG,OAV3B,aAAa,KAAoB,WAAW;GACxD,aAAa,UAAU;GACvB,SAAS,EAAE;EACb,GAAG,CAAC,CAOyC;EAAG,cAL3B,kBACZ,aAAa,YAAY,OAAO,IAAI,KAAK,IAAI,IAAI,aAAa,SACrE,CAAC,CAGwD;CAAE;AAC/D"}

package/dist/hooks/useSpeechRecorder.cjs

@@ -1,17 +1,6 @@
 'use client';
-'use strict';
-
-var chunkUDCQTOVU_cjs = require('../chunk-UDCQTOVU.cjs');
-
-
-
-Object.defineProperty(exports, "CAPTURE_PROCESSOR_SOURCE", {
-  enumerable: true,
-  get: function () { return chunkUDCQTOVU_cjs.CAPTURE_PROCESSOR_SOURCE; }
-});
-Object.defineProperty(exports, "useSpeechRecorder", {
-  enumerable: true,
-  get: function () { return chunkUDCQTOVU_cjs.useSpeechRecorder; }
-});
-//# sourceMappingURL=useSpeechRecorder.cjs.map
-//# sourceMappingURL=useSpeechRecorder.cjs.map
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_useSpeechRecorder = require("../useSpeechRecorder--O_f-xvt.cjs");
+exports.CAPTURE_PROCESSOR_SOURCE = require_useSpeechRecorder.CAPTURE_PROCESSOR_SOURCE;
+exports.useSpeechRecorder = require_useSpeechRecorder.useSpeechRecorder;

package/dist/hooks/useSpeechRecorder.d.cts

@@ -1,127 +1,2 @@
-import { a as SpeechRecorderStatus, S as SpeechRecorderError, R as RecordedTake } from '../machine-CuwKqWXC.cjs';
-
-/**
- * The audio worklet module `useSpeechRecorder` captures through, as source
- * text — exported so an application with a strict Content-Security-Policy can
- * serve it itself.
- *
- * By default the hook loads this text from a `blob:` URL. A worklet module is
- * loaded as a script, so it is `script-src` that must allow `blob:` —
- * `worker-src` does not govern it. Where that is refused, write this string to
- * a file your policy's `script-src` does allow, at build time and from the
- * installed package so it moves with the version you run, and pass that file's
- * URL as `workletUrl`:
- *
- * ```ts
- * import { writeFileSync } from 'node:fs';
- * import { CAPTURE_PROCESSOR_SOURCE } from '@intellectif/lk-react/hooks/useSpeechRecorder';
- *
- * writeFileSync('public/lk-speech-capture.js', CAPTURE_PROCESSOR_SOURCE);
- * ```
- *
- * **The contract** a module at `workletUrl` must meet, which this source does:
- * register an `AudioWorkletProcessor` under the name `lk-speech-capture`, and
- * from its `process(inputs)` post the first input's channels to its `port` as
- * an array with one `Float32Array` per channel, **copied** — the render
- * quantum's buffers belong to the audio thread and are overwritten on the next
- * quantum, so a block posted without copying arrives as whatever the
- * microphone heard some milliseconds later. Return `true`, which keeps the
- * processor alive while its source is silent. Anything else changes what is
- * recorded, so serve this text unchanged rather than a copy of your own.
- */
-declare const CAPTURE_PROCESSOR_SOURCE: string;
-
-interface SpeechRecorderOptions {
-    /** The longest a take may be. Reached, the recording stops itself. */
-    maxDurationMs: number;
-    /** Shorter than this and the take is refused as `too-short`. */
-    minDurationMs?: number;
-    /** How many takes the learner may make. Unbounded when absent. */
-    maxTakes?: number;
-    /**
-     * The URL of a self-hosted copy of {@link CAPTURE_PROCESSOR_SOURCE}, for an
-     * application whose Content-Security-Policy does not allow `blob:` in
-     * `script-src`. Serve that string unchanged; the contract a module here must
-     * meet is written on it.
-     *
-     * **A URL that does not work is not reported.** If the module fails to load,
-     * or loads without registering `lk-speech-capture`, the hook records through
-     * the deprecated `ScriptProcessorNode` on the main thread instead — the
-     * fallback it keeps for engines without audio worklets — and a recorder with
-     * a broken `workletUrl` looks like a working one. Only an engine with neither
-     * path reports `error: 'unsupported'`. Check that the module is actually
-     * fetched.
-     */
-    workletUrl?: string;
-}
-interface SpeechRecorder {
-    status: SpeechRecorderStatus;
-    error: SpeechRecorderError | null;
-    /** The loudest block since the last update, 0..1. */
-    level: number;
-    /** How much audio has been captured, from the sample count. */
-    elapsedMs: number;
-    take: RecordedTake | null;
-    takesUsed: number;
-    /** Whether a take remains. Not whether a `start()` would be accepted now. */
-    canRecord: boolean;
-    /** Opens the microphone and begins capturing. **Never rejects.** */
-    start(): Promise<void>;
-    /** Ends the capture and encodes the take. */
-    stop(): void;
-    /** Throws the take away and releases the microphone. */
-    discard(): void;
-    /**
-     * Starts over: releases the microphone, throws the take away **and gives the
-     * budget back**.
-     *
-     * That last part is the whole difference from {@link SpeechRecorder.discard},
-     * which deliberately refunds nothing — a budget a re-record gave back would
-     * bound nothing. A reset is for a recorder that has been handed a different
-     * reading while it stayed mounted: the takes belong to the activity, so the
-     * next activity's are its own. Calling it for the same reading hands a
-     * learner takes they have already spent.
-     */
-    reset(): void;
-}
-/**
- * Records a take of speech as mono 16-bit PCM WAV at 16 kHz.
- *
- * That is the one format the SDK measures directly: `inspectWav` reads it
- * without a decoding library, and it is what every mainstream pronunciation
- * assessor accepts. A take is captured at whatever rate the device runs at,
- * downmixed to mono, low-pass filtered and resampled, then encoded — so what a
- * server measures is what this hook produced, not a claim about it.
- *
- * **Server rendering.** `status`, `error` and `canRecord` are derived from the
- * take count alone and never from a browser global, so the markup a server
- * produces is the markup the browser's first render produces. Support is
- * discovered inside {@link SpeechRecorder.start} and reported as
- * `error: 'unsupported'`; the obvious `!!navigator.mediaDevices` guard at
- * render time would make a server render and its hydration disagree.
- *
- * **Identity.** `start`, `stop`, `discard` and `reset` keep one identity for the
- * life of the hook, so they are safe in a dependency array. The returned object keeps
- * one identity for as long as none of its values changes, so a render caused
- * by something else does not invalidate an effect that depends on it.
- *
- * `start()` does nothing when no take remains, so `canRecord` is presentation:
- * mark the control `aria-disabled` rather than `disabled`, which would take it
- * out of the tab order and leave a learner nothing to read.
- *
- * ```tsx
- * const recorder = useSpeechRecorder({ maxDurationMs: 20_000, maxTakes: 3 });
- * <button
- *   type="button"
- *   aria-disabled={!recorder.canRecord}
- *   onClick={() => {
- *     void recorder.start();
- *   }}
- * >
- *   Record
- * </button>
- * ```
- */
-declare function useSpeechRecorder(options: SpeechRecorderOptions): SpeechRecorder;
-
-export { CAPTURE_PROCESSOR_SOURCE, RecordedTake, type SpeechRecorder, SpeechRecorderError, type SpeechRecorderOptions, SpeechRecorderStatus, useSpeechRecorder };
+import { a as RecordedTake, i as CAPTURE_PROCESSOR_SOURCE, n as SpeechRecorderOptions, o as SpeechRecorderError, r as useSpeechRecorder, s as SpeechRecorderStatus, t as SpeechRecorder } from "../useSpeechRecorder-DtAYvl02.cjs";
+export { CAPTURE_PROCESSOR_SOURCE, type RecordedTake, SpeechRecorder, type SpeechRecorderError, SpeechRecorderOptions, type SpeechRecorderStatus, useSpeechRecorder };