@intellectif/lk-react 23.0.0 → 23.1.0

package/dist/chunk-J2QIHZ3H.cjs

@@ -1,27 +0,0 @@
-'use client';
-'use strict';
-
-var react = require('react');
-
-// src/components/shared/sequence-slot.ts
-var SequenceSlotContext = react.createContext(null);
-var lastTake = 0;
-function mintTake() {
-  lastTake += 1;
-  return lastTake;
-}
-var takes = /* @__PURE__ */ new WeakMap();
-function stampTake(value, take) {
-  takes.set(value, take);
-  return value;
-}
-function takeOf(value) {
-  return typeof value === "object" && value !== null ? takes.get(value) : void 0;
-}
-
-exports.SequenceSlotContext = SequenceSlotContext;
-exports.mintTake = mintTake;
-exports.stampTake = stampTake;
-exports.takeOf = takeOf;
-//# sourceMappingURL=chunk-J2QIHZ3H.cjs.map
-//# sourceMappingURL=chunk-J2QIHZ3H.cjs.map

package/dist/chunk-J2QIHZ3H.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/shared/sequence-slot.ts"],"names":["createContext"],"mappings":";;;;;AAoFO,IAAM,mBAAA,GAAsBA,oBAA0C,IAAI;AASjF,IAAI,QAAA,GAAW,CAAA;AAGR,SAAS,QAAA,GAAmB;AACjC,EAAA,QAAA,IAAY,CAAA;AACZ,EAAA,OAAO,QAAA;AACT;AAOA,IAAM,KAAA,uBAAY,OAAA,EAAwB;AAGnC,SAAS,SAAA,CAA4B,OAAU,IAAA,EAAiB;AACrE,EAAA,KAAA,CAAM,GAAA,CAAI,OAAO,IAAI,CAAA;AACrB,EAAA,OAAO,KAAA;AACT;AAGO,SAAS,OAAO,KAAA,EAAoC;AACzD,EAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,OAAO,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA,GAAI,MAAA;AAC1E","file":"chunk-J2QIHZ3H.cjs","sourcesContent":["'use client';\n\nimport type { ResolvedDeliveryPolicy, ResolvedItemScoringPolicy } from '@intellectif/lk-core';\nimport { createContext } from 'react';\nimport type { RenderMode } from '../types.js';\n\n/**\n * How far a take that was handed in has got, as a pager deciding whether its\n * set is finished needs to know it.\n *\n * - `in-flight` — being stored or being judged. The set waits for it.\n * - `retryable` — it failed, and the learner is being offered another try at\n *   the SAME take. The set waits for it while the learner is on that question.\n * - `settled` — nothing more will come of it: a grade, a take with no grade, a\n *   failure nobody can retry, or a take the learner walked away from.\n */\nexport type TakeState = 'in-flight' | 'retryable' | 'settled';\n\n/**\n * Where a question is with its tries, as a pager deciding whether its set is\n * finished needs to know it.\n *\n * - `offered` — a graded answer short of full marks, with another try on offer.\n *   The set waits for it while the learner is on that question: leaving it is\n *   declining the try.\n * - `retrying` — the learner pressed \"Try again\" and has not answered again.\n *   The set waits for it wherever the learner is, as it waits for any question\n *   not yet answered: the grade it holds is the one being replaced.\n * - `none` — neither.\n */\nexport type TriesState = 'none' | 'offered' | 'retrying';\n\n/**\n * What a pager hands the one slot it renders, and only through\n * {@link SequenceSlotContext} — never as a prop, so none of it can appear on a\n * public component's signature. A consumer string in any of it could stop\n * another component's microphone or finish another paper's set.\n */\nexport interface SequenceSlotChannel {\n  /**\n   * The capture-registry group whose captures stop when the slot's pane is\n   * hidden. Minted per pager and per slot, so no two pagers share one.\n   */\n  readonly captureGroup: string;\n  /**\n   * The mode the PAPER around this question is being delivered in, read live.\n   *\n   * It is how the AI hooks know an exam they were not told about. A host that\n   * draws its own question passes `renderMode` on to them, but nothing makes\n   * it: the hooks would then default to `practice` and, under an\n   * `LkAiProvider` somewhere above, offer hints on a paper of record. The set\n   * around the question decides, and an `exam` here wins over anything the\n   * caller passes or forgets to pass.\n   */\n  readonly renderMode: RenderMode;\n  /**\n   * The delivery policy of the PAPER around this question, read live, for the\n   * same reason as the mode: whatever a host's own question was handed, the\n   * paper's restrictions hold in it. See `useDeliveryPolicy`.\n   */\n  readonly delivery: ResolvedDeliveryPolicy;\n  /**\n   * The scoring policy of the PAPER around this question, read live, when the\n   * paper was given one: it holds for every question in it, however drawn.\n   * `undefined` when the paper has none, so a question's own applies.\n   */\n  readonly scoring: ResolvedItemScoringPolicy | undefined;\n  /**\n   * Whether the paper has closed every question's tries: it reported its set,\n   * or its learner finished. A \"Try again\" after that would change a grade the\n   * paper has already handed on.\n   */\n  readonly triesClosed: boolean;\n  /** Tells the paper where this question is with its tries: see {@link TriesState}. */\n  triesState(state: TriesState): void;\n  /**\n   * Reports the state of the take numbered `take`, a number from\n   * {@link mintTake}. A take numbered below the slot's latest is a take the\n   * learner has since replaced, and the pager ignores it.\n   */\n  takeState(take: number, state: TakeState): void;\n}\n\n/** `null` outside a pager: a standalone component belongs to no slot. */\nexport const SequenceSlotContext = createContext<SequenceSlotChannel | null>(null);\n\n/**\n * The last take number handed out. Module-level and never reset, so a number\n * is unique for the life of the page: across mounts, across papers, and across\n * two pagers side by side. A result can therefore only ever match the take that\n * produced it, whatever slot and activity ids a later paper reuses — ids a host\n * chooses, and can repeat, never decide it.\n */\nlet lastTake = 0;\n\n/** A take number no other take on this page has had, or will have. */\nexport function mintTake(): number {\n  lastTake += 1;\n  return lastTake;\n}\n\n/**\n * The take each reported value belongs to. A `WeakMap` rather than a field, so\n * a response or a result a host receives carries no extra key it would persist\n * or compare, and the number never outlives the object.\n */\nconst takes = new WeakMap<object, number>();\n\n/** Marks `value` as produced by take `take`, and returns it. */\nexport function stampTake<T extends object>(value: T, take: number): T {\n  takes.set(value, take);\n  return value;\n}\n\n/** The take `value` was produced by, or `undefined` when nothing stamped it. */\nexport function takeOf(value: unknown): number | undefined {\n  return typeof value === 'object' && value !== null ? takes.get(value) : undefined;\n}\n"]}