@intellectif/lk-core 1.2.0 → 1.4.0

package/dist/index-BAfEHCnD.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BAfEHCnD.d.cts","names":[],"sources":["../src/scoring/rounding.ts","../src/types/speech.ts","../src/scoring/compose.ts","../src/types/item-scoring.ts","../src/scoring/dictation/align.ts","../src/scoring/dictation/chars.ts","../src/scoring/dictation/normalize.ts","../src/scoring/item-scoring.ts","../src/scoring/pass-threshold.ts","../src/scoring/speech/align.ts","../src/scoring/speech/assessment.ts","../src/scoring/speech/grade.ts","../src/scoring/speech/limits.ts","../src/scoring/speech/wav.ts","../src/scoring/unscorable.ts","../src/scoring/index.ts"],"mappings":"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"}

package/dist/index-BqMXWuNC.d.cts

@@ -0,0 +1,153 @@
+import { Sn as XAPIStatement, bn as XAPIResult, gn as XAPIContext, mn as XAPIActor, sn as ScoringResult } from "./ai-CnmLPMzd.cjs";
+//#region src/xapi/verbs.d.ts
+/**
+ * The set of xAPI verbs emitted by SDK activities, keyed by a stable
+ * identifier mapped to its canonical xAPI verb IRI (xAPI 1.0.3 / ADL registry).
+ */
+declare const XAPIVerb: {
+  readonly ANSWERED: "http://adlnet.gov/expapi/verbs/answered";
+  readonly COMPLETED: "http://adlnet.gov/expapi/verbs/completed";
+  readonly EXPERIENCED: "http://adlnet.gov/expapi/verbs/experienced";
+  readonly INTERACTED: "http://adlnet.gov/expapi/verbs/interacted";
+  readonly ATTEMPTED: "http://adlnet.gov/expapi/verbs/attempted";
+  readonly PASSED: "http://adlnet.gov/expapi/verbs/passed";
+  readonly FAILED: "http://adlnet.gov/expapi/verbs/failed";
+  readonly WATCHED: "https://w3id.org/xapi/video/verbs/watched";
+  /**
+   * Emitted for deferred-grading submissions (e.g. written-response): the
+   * learner has submitted work whose grade does not exist yet, so `answered`
+   * (which implies a scored response) would be wrong. xAPI 1.0.3 defines no
+   * canonical "submit" verb; the Activity Streams 1.0 IRI is the established
+   * community choice.
+   */
+  readonly SUBMITTED: "http://activitystrea.ms/schema/1.0/submit";
+  /**
+   * Emitted when an asynchronous grader produces a grade for work that was
+   * previously only SUBMITTED. Distinct from `answered`, which asserts the
+   * grade existed at submission time — here the learner acted earlier and the
+   * grade arrived later, often from a different actor (an AI or a teacher).
+   */
+  readonly SCORED: "http://adlnet.gov/expapi/verbs/scored";
+};
+/** Union of the valid `XAPIVerb` keys. */
+type XAPIVerbKey = keyof typeof XAPIVerb;
+/**
+ * Default `en-US` display label for each verb, used to populate
+ * `XAPIVerbObject.display` when the builder resolves a verb key.
+ */
+declare const XAPI_VERB_DISPLAY: Record<XAPIVerbKey, Record<string, string>>;
+//#endregion
+//#region src/xapi/builder.d.ts
+/** Caller-supplied activity object descriptor (mapped to an xAPI Activity). */
+interface XAPIObjectParams {
+  /** Activity IRI. */
+  id: string;
+  name?: Record<string, string>;
+  description?: Record<string, string>;
+  /** Activity type IRI. */
+  type?: string;
+  /** xAPI cmi.interaction type (e.g. `choice`, `fill-in`, `long-fill-in`). */
+  interactionType?: string;
+  /** Correct-responses patterns, per the xAPI CRP format. */
+  correctResponsesPattern?: string[];
+  /** For choice-family interactions: the available components. */
+  choices?: Array<{
+    id: string;
+    description?: Record<string, string>;
+  }>;
+}
+/** Parameters for the generic {@link xAPIBuilder.buildStatement}. */
+interface XAPIStatementParams {
+  actor: XAPIActor;
+  verb: XAPIVerbKey;
+  object: XAPIObjectParams;
+  result?: XAPIResult;
+  context?: XAPIContext;
+}
+/** Parameters for {@link xAPIBuilder.buildAnsweredStatement} (verb = ANSWERED). */
+interface AnsweredStatementParams {
+  actor: XAPIActor;
+  object: XAPIObjectParams;
+  scoringResult: ScoringResult;
+  timeSpentMs: number;
+  /** Serialized learner response string. */
+  response?: string;
+  context?: XAPIContext;
+  resultExtensions?: Record<string, unknown>;
+}
+/**
+ * Parameters for {@link xAPIBuilder.buildSubmittedStatement} (verb =
+ * SUBMITTED — deferred-grading submissions). Carries NO score, success, or
+ * completion: the grade does not exist yet.
+ */
+interface SubmittedStatementParams {
+  actor: XAPIActor;
+  object: XAPIObjectParams;
+  timeSpentMs: number;
+  /** Serialized learner response string (e.g. the submitted text). */
+  response?: string;
+  context?: XAPIContext;
+  resultExtensions?: Record<string, unknown>;
+}
+/** Parameters for {@link xAPIBuilder.buildCompletedStatement} (verb = COMPLETED). */
+interface CompletedStatementParams {
+  actor: XAPIActor;
+  object: XAPIObjectParams;
+  scoringResult?: ScoringResult;
+  timeSpentMs: number;
+  context?: XAPIContext;
+  resultExtensions?: Record<string, unknown>;
+}
+/**
+ * Constructs xAPI 1.0.3 Statements. Every call stamps a fresh UUID v4 `id`,
+ * an ISO 8601 `timestamp`, and `version: '1.0.3'`. Not pure by design —
+ * statements are unique events.
+ */
+declare const xAPIBuilder: {
+  buildStatement(params: XAPIStatementParams): XAPIStatement;
+  buildAnsweredStatement(params: AnsweredStatementParams): XAPIStatement;
+  /**
+   * Builds a statement for a deferred-grading submission (e.g. a written
+   * response). Verb is SUBMITTED and the result deliberately omits `score`,
+   * `success`, and `completion` — none of them exist until the asynchronous
+   * grader runs; only `duration`, `response`, and extensions are recorded.
+   */
+  buildSubmittedStatement(params: SubmittedStatementParams): XAPIStatement;
+  buildCompletedStatement(params: CompletedStatementParams): XAPIStatement;
+};
+/**
+ * Builds the xAPI `object.definition` interop fields for an activity from its
+ * REGISTERED descriptor, rather than having every renderer hand-roll them.
+ *
+ * `ActivityTypeDescriptor.interop` declares the activity-type IRI, the
+ * cmi.interaction type and how to derive `correctResponsesPattern`; before
+ * this, those fields had no reader anywhere and each component rebuilt the
+ * same strings inline — the same "declared but never used" defect the SDK
+ * fixed elsewhere. Reading them here also means a consumer-registered type
+ * gets correct interop for free.
+ *
+ * Returns an empty object for an unregistered type or one that declares no
+ * interop, so it is always safe to spread.
+ */
+declare function xapiDefinitionFor(data: {
+  type: string;
+}): Partial<XAPIObjectParams>;
+//#endregion
+//#region src/xapi/validators.d.ts
+/**
+ * Validates a constructed {@link XAPIStatement} against the xAPI 1.0.3
+ * structural contract.
+ *
+ * In development a structural failure throws (caught early); in production it
+ * logs a warning and returns (the statement is still sent — see the design's
+ * Error Handling table). Uses a `zod/v4` schema rather than `ajv` + an
+ * external JSON Schema to keep `lk-core` dependency-free.
+ *
+ * NOTE: `ActivitySchemaError` is reused here per the task spec; its
+ * `activityType` field carries the sentinel `'xAPIStatement'`. A dedicated
+ * `XAPIValidationError` would be semantically cleaner — flagged for review.
+ */
+declare function validateXAPIStatement(statement: XAPIStatement): void;
+//#endregion
+export { XAPIObjectParams as a, xapiDefinitionFor as c, XAPI_VERB_DISPLAY as d, SubmittedStatementParams as i, XAPIVerb as l, AnsweredStatementParams as n, XAPIStatementParams as o, CompletedStatementParams as r, xAPIBuilder as s, validateXAPIStatement as t, XAPIVerbKey as u };
+//# sourceMappingURL=index-BqMXWuNC.d.cts.map

package/dist/index-BqMXWuNC.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BqMXWuNC.d.cts","names":[],"sources":["../src/xapi/verbs.ts","../src/xapi/builder.ts","../src/xapi/validators.ts"],"mappings":";;;;;;cAIa;;;;;;;;;;;;;;;;;;;;;;;;;;KA2BD,2BAA2B;;;;;cAM1B,mBAAmB,OAAO,aAAa;;;;UCxBnC;;EAEf;EACA,OAAO;EACP,cAAc;;EAEd;;EAEA;;EAEA;;EAEA,UAAU;IAAQ;IAAY,cAAc;;;;UAI7B;EACf,OAAO;EACP,MAAM;EACN,QAAQ;EACR,SAAS;EACT,UAAU;;;UAIK;EACf,OAAO;EACP,QAAQ;EACR,eAAe;EACf;;EAEA;EACA,UAAU;EACV,mBAAmB;;;;;;;UAQJ;EACf,OAAO;EACP,QAAQ;EACR;;EAEA;EACA,UAAU;EACV,mBAAmB;;;UAIJ;EACf,OAAO;EACP,QAAQ;EACR,gBAAgB;EAChB;EACA,UAAU;EACV,mBAAmB;;;;;;;cAiGR;EACY,eAAA,QAAA,sBAAsB;EAoBd,uBAAA,QAAA,0BAA0B;;;;;;;EAqBzB,wBAAA,QAAA,2BAA2B;EAc3B,wBAAA,QAAA,2BAA2B;;;;;;;;;;;;;;;;iBA8B7C,kBAAkB;EAAQ;IAAiB,QAAQ;;;;;;;;;;;;;;;;iBClHnD,sBAAsB,WAAW"}