@happyvertical/smrt-education 0.57.42 → 0.57.44

package/dist/course-authoring-models.d.ts

@@ -0,0 +1,291 @@
+import { SmrtCollection, SmrtObject, type SmrtSaveOptions } from '@happyvertical/smrt-core';
+import type { CourseLicenseKind } from './catalog.js';
+/** Immutable snapshot of one authored course draft. The head row selects the draft. */
+export declare class CourseRevision extends SmrtObject {
+    tenantId: string;
+    courseId: string;
+    parentRevisionId: string | null;
+    sequence: number;
+    authorUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    provenance: string;
+    fieldProvenanceJson: string;
+    title: string;
+    summary: string;
+    subject: string;
+    theme: string;
+    levelMin: number;
+    levelMax: number;
+    objectivesJson: string;
+    sectionsJson: string;
+    licenseKind: CourseLicenseKind;
+    requestKey: string;
+    payloadDigest: string;
+    contentDigest: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class CourseRevisionCollection extends SmrtCollection<CourseRevision> {
+    static readonly _itemClass: typeof CourseRevision;
+}
+/** Immutable lesson snapshot with a stable cross-version `lessonKey`. */
+export declare class LessonRevision extends SmrtObject {
+    tenantId: string;
+    courseId: string;
+    lessonKey: string;
+    parentRevisionId: string | null;
+    title: string;
+    body: string;
+    lessonType: string;
+    completionRule: string;
+    estimatedMinutes: number;
+    difficulty: number;
+    modality: string;
+    externalRef: string;
+    externalUrl: string;
+    licenseKind: CourseLicenseKind;
+    /** The lesson's own licence before materials; sticky across revisions of a lessonKey. */
+    ownLicenseKind: string;
+    materialsJson: string;
+    /** Ordered `LessonQuestionRefInput`s naming immutable question revisions. */
+    questionsJson: string;
+    /** Flat render parameters that, with the refs, make up the worksheet version id. */
+    layoutParamsJson: string;
+    provenance: string;
+    fieldProvenanceJson: string;
+    authorUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    contentDigest: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class LessonRevisionCollection extends SmrtCollection<LessonRevision> {
+    static readonly _itemClass: typeof LessonRevision;
+}
+/**
+ * The only mutable authoring row: the draft head. It moves solely through the
+ * service's expected-head compare-and-swap; its identity never changes.
+ */
+export declare class CourseDraftHead extends SmrtObject {
+    tenantId: string;
+    courseId: string;
+    headRevisionId: string;
+    version: number;
+    updatedByUserId: string;
+    updatedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class CourseDraftHeadCollection extends SmrtCollection<CourseDraftHead> {
+    static readonly _itemClass: typeof CourseDraftHead;
+}
+/** Append-only release decision bound to one revision and the review that allowed it. */
+export declare class CourseRelease extends SmrtObject {
+    tenantId: string;
+    courseId: string;
+    revisionId: string;
+    /** The immutable Course row materialized for this release. */
+    releaseCourseId: string;
+    releaseNumber: number;
+    reviewId: string;
+    actorUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    requestKey: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class CourseReleaseCollection extends SmrtCollection<CourseRelease> {
+    static readonly _itemClass: typeof CourseRelease;
+}
+/** Stable lesson identity for one release's immutable Lesson row. */
+export declare class ReleasedLesson extends SmrtObject {
+    tenantId: string;
+    courseId: string;
+    releaseId: string;
+    lessonKey: string;
+    lessonRevisionId: string;
+    lessonId: string;
+    sectionId: string;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class ReleasedLessonCollection extends SmrtCollection<ReleasedLesson> {
+    static readonly _itemClass: typeof ReleasedLesson;
+}
+/** Reversible archive/unarchive decisions; the latest sequence is the state. */
+export declare class CourseArchiveDecision extends SmrtObject {
+    tenantId: string;
+    courseId: string;
+    action: string;
+    sequence: number;
+    actorUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    requestKey: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class CourseArchiveDecisionCollection extends SmrtCollection<CourseArchiveDecision> {
+    static readonly _itemClass: typeof CourseArchiveDecision;
+}
+/** Audit record left when an unreferenced draft is discarded. */
+export declare class CourseDiscardTombstone extends SmrtObject {
+    tenantId: string;
+    courseId: string;
+    title: string;
+    headRevisionId: string;
+    revisionCount: number;
+    reason: string;
+    actorUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    requestKey: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class CourseDiscardTombstoneCollection extends SmrtCollection<CourseDiscardTombstone> {
+    static readonly _itemClass: typeof CourseDiscardTombstone;
+}
+/**
+ * Append-only record of which release an enrollment follows. Enrollment keeps
+ * its immutable course id (the release Course row it was assigned); the latest
+ * pin by sequence is the enrollment's current release.
+ */
+export declare class EnrollmentReleasePin extends SmrtObject {
+    tenantId: string;
+    enrollmentId: string;
+    learnerId: string;
+    /** Authored course identity. */
+    courseId: string;
+    releaseId: string;
+    previousReleaseId: string | null;
+    kind: string;
+    sequence: number;
+    /** Empty for automatic moves, which have no actor. */
+    actorUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    /** Automatic moves: the delegation id recorded on the opt-in followed; empty otherwise. */
+    optInDelegationId: string;
+    /** Host assignment-setting value relied on; automatic moves copy the opt-in's. */
+    policyBasis: string;
+    /** Scope of the opt-in an automatic move followed ('course' | 'enrollment'); empty otherwise. */
+    optInScope: string;
+    requestKey: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class EnrollmentReleasePinCollection extends SmrtCollection<EnrollmentReleasePin> {
+    static readonly _itemClass: typeof EnrollmentReleasePin;
+}
+/** Recorded opt-in/out of auto-upgrade at course or enrollment scope. */
+export declare class CourseUpgradeChoice extends SmrtObject {
+    tenantId: string;
+    courseId: string;
+    /** Empty for a course-level choice. */
+    enrollmentId: string;
+    enabled: boolean;
+    sequence: number;
+    actorUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    /** Host assignment-setting value relied on for this choice. */
+    policyBasis: string;
+    requestKey: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class CourseUpgradeChoiceCollection extends SmrtCollection<CourseUpgradeChoice> {
+    static readonly _itemClass: typeof CourseUpgradeChoice;
+}
+/**
+ * Append-only record of an automatic upgrade that was not performed because the
+ * host denied the per-learner assignment decision. The enrollment stays pinned.
+ */
+export declare class EnrollmentAutoUpgradeSkip extends SmrtObject {
+    tenantId: string;
+    enrollmentId: string;
+    learnerId: string;
+    courseId: string;
+    /** The release the enrollment was not moved to. */
+    releaseId: string;
+    /** 'course' or 'enrollment': the scope of the opt-in that was followed. */
+    optInScope: string;
+    optInActorUserId: string;
+    optInDelegatingGuardianUserId: string;
+    optInDelegationId: string;
+    policyBasis: string;
+    /** The authorizer's bounded reason, else 'not-authorized'. Never a thrown message. */
+    reason: string;
+    /** The authorizer's short code (`[a-z0-9._-]`, up to 64); empty when none. */
+    code: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class EnrollmentAutoUpgradeSkipCollection extends SmrtCollection<EnrollmentAutoUpgradeSkip> {
+    static readonly _itemClass: typeof EnrollmentAutoUpgradeSkip;
+}
+/**
+ * Append-only audit of a delegated-agent assignment: the agent that created the
+ * enrollment, the guardian it acted for and the host's delegation id. Written
+ * only for delegated enrollments, in the enrollment's own transaction. It is
+ * deliberately separate from `Enrollment`, whose released table is not altered.
+ */
+export declare class EnrollmentAssignmentRecord extends SmrtObject {
+    tenantId: string;
+    enrollmentId: string;
+    learnerId: string;
+    actorUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class EnrollmentAssignmentRecordCollection extends SmrtCollection<EnrollmentAssignmentRecord> {
+    static readonly _itemClass: typeof EnrollmentAssignmentRecord;
+}
+/**
+ * Append-only audit of a delegated-agent curriculum creation: the agent, the
+ * guardian it acted for and the host's delegation id. Written only for delegated
+ * `createCurriculum` calls, in the curriculum's own transaction; `Curriculum`
+ * itself is not altered.
+ */
+export declare class CurriculumCreationRecord extends SmrtObject {
+    tenantId: string;
+    curriculumId: string;
+    learnerId: string;
+    actorUserId: string;
+    delegatingGuardianUserId: string;
+    delegationId: string;
+    recordedAt: Date;
+    constructor(options?: Record<string, unknown>);
+    delete(): Promise<void>;
+    save(options?: SmrtSaveOptions): Promise<this>;
+}
+export declare class CurriculumCreationRecordCollection extends SmrtCollection<CurriculumCreationRecord> {
+    static readonly _itemClass: typeof CurriculumCreationRecord;
+}
+//# sourceMappingURL=course-authoring-models.d.ts.map

package/dist/course-authoring-models.d.ts.map

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

package/dist/course-authoring-service.d.ts

@@ -0,0 +1,244 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { type AutoUpgradeSkipView, type CourseAuthoringAction, type CourseAuthoringActor, type CourseAuthoringAuthorizer, type CourseAuthoringOperation, type CourseDelegationVerifier, type CourseDraftInput, type CourseHeadView, type CourseLessonRevisionView, type CourseLifecycleState, type CourseMaterialCopyPort, type CoursePage, type CoursePageRequest, type CourseReferenceGuard, type CourseReleaseView, type CourseRevisionView, type CourseStateView, type CourseSummaryView, type CourseUpgradeChoiceView, type EnrollmentPinView, type EnrollmentReleaseView, type ReleaseReviewGate, type SetAutoUpgradeResult } from './course-authoring-contracts.js';
+import { type CourseRevision, type LessonRevision } from './course-authoring-models.js';
+type Row = Record<string, unknown>;
+type Tx = DatabaseInterface;
+/**
+ * Normalizes an authorizer answer. Only `allowed === true` allows. Reason and
+ * code are host-chosen labels: strip control characters, bound them and drop
+ * anything invalid, so a skip row can never carry free-form or unbounded text.
+ */
+declare function readDecision(result: unknown): {
+    allowed: boolean;
+    reason: string;
+    code: string;
+    /** Raw, unvalidated; only the assign flows read it (see `resolvePolicyBasis`). */
+    policyBasis?: unknown;
+};
+export interface CourseAuthoringServiceOptions {
+    /** Supplied by the review feature; without it release always fails closed. */
+    releaseReviewGate?: ReleaseReviewGate;
+    /** Reports review/variant rows that must block discarding a draft. */
+    referenceGuard?: CourseReferenceGuard;
+    /** Copies uploaded originals to education-owned assets. */
+    materialCopy?: CourseMaterialCopyPort;
+    /**
+     * Required for any delegated (agent) request: without it delegation fields
+     * are refused. Runs on the transaction executor before the authorizer.
+     */
+    verifyDelegation?: CourseDelegationVerifier;
+}
+/**
+ * Actor-bound authoring of revisioned courses. All writes are one transaction;
+ * every authorizer call receives that transaction's executor.
+ */
+export declare class CourseAuthoringService {
+    private readonly db;
+    private readonly authorizer;
+    private readonly options;
+    constructor(db: DatabaseInterface, authorizer: CourseAuthoringAuthorizer, options?: CourseAuthoringServiceOptions);
+    protected run<T>(operation: (tx: Tx) => Promise<T>): Promise<T>;
+    protected authorize(tx: Tx, actor: CourseAuthoringActor, action: CourseAuthoringAction, operation: CourseAuthoringOperation, extra?: {
+        courseId?: string;
+        enrollmentId?: string;
+        learnerId?: string;
+        releaseId?: string;
+        releaseCourseId?: string;
+    }): Promise<ReturnType<typeof readDecision>>;
+    /**
+     * Fail closed: no port, a denial or a throw all mean the delegation is not
+     * verified. The decision carries the verifier's sanitized `{reason, code}` only
+     * for an object refusal; a boolean, a throw or a missing port is generic.
+     */
+    private delegationDecision;
+    private delegationVerified;
+    protected identityRow(tx: Tx, tenantId: string, courseId: string): Promise<Row>;
+    protected state(tx: Tx, tenantId: string, courseId: string): Promise<CourseLifecycleState>;
+    private archiveDecisions;
+    protected lockHead(tx: Tx, tenantId: string, courseId: string): Promise<void>;
+    protected writableDraft(tx: Tx, tenantId: string, courseId: string): Promise<void>;
+    /** Creates the stable course identity, its first (empty) revision and draft head. */
+    createCourse(request: CourseAuthoringActor & {
+        requestKey: string;
+        title: string;
+        summary?: string;
+        subject?: string;
+        theme?: string;
+        levelMin?: number;
+        levelMax?: number;
+        objectives?: string[];
+    }): Promise<CourseHeadView>;
+    protected headView(tx: Tx, tenantId: string, courseId: string): Promise<CourseHeadView>;
+    private appendRevision;
+    /**
+     * Appends a revision and moves the draft head by expected-head compare and
+     * swap. A retried request key replays its original result; the same key with a
+     * different payload is a typed conflict.
+     */
+    saveDraft(request: CourseAuthoringActor & {
+        courseId: string;
+        expectedHeadRevisionId: string;
+        requestKey: string;
+        draft: CourseDraftInput;
+    }): Promise<CourseHeadView & {
+        revisionId: string;
+    }>;
+    /** The save path on a caller-supplied transaction, so composed writes share CAS and authz. */
+    protected saveDraftIn(tx: Tx, request: CourseAuthoringActor & {
+        courseId: string;
+        expectedHeadRevisionId: string;
+        requestKey: string;
+        draft: CourseDraftInput;
+    }): Promise<CourseHeadView & {
+        revisionId: string;
+    }>;
+    /** Extension point run inside the save transaction after the head moved. */
+    protected onDraftRevisionAppended(_tx: Tx, _actor: CourseAuthoringActor, _revision: {
+        courseId: string;
+        revisionId: string;
+    }): Promise<void>;
+    private revisionLessonIds;
+    /**
+     * Restricted own licences recorded anywhere in the course history, indexed by
+     * lessonKey and by normalized body / title-and-body digest.
+     */
+    private ownLicenceHistory;
+    /** Assets this course already owns through earlier lesson revisions. */
+    private knownMaterials;
+    private resolveMaterial;
+    protected lessonView(row: LessonRevision | Row): CourseLessonRevisionView;
+    /** Lesson question refs must name existing immutable revisions of this tenant. */
+    private requireQuestionRevisions;
+    protected revisionView(tx: Tx, tenantId: string, revision: CourseRevision): Promise<CourseRevisionView>;
+    /** Reads a draft revision (the head unless `revisionId` is given), answer keys included. */
+    readDraft(request: CourseAuthoringActor & {
+        courseId: string;
+        revisionId?: string;
+    }): Promise<{
+        head: CourseHeadView;
+        revision: CourseRevisionView;
+    }>;
+    getCourse(request: CourseAuthoringActor & {
+        courseId: string;
+    }): Promise<CourseStateView>;
+    private courseState;
+    /**
+     * Authored courses of the tenant, oldest first (created time, then id), with
+     * state, draft head, latest release and archive state. Discarded courses are
+     * excluded unless `includeDiscarded` is true. Needs `read-draft`.
+     */
+    listCourses(request: CourseAuthoringActor & CoursePageRequest & {
+        includeDiscarded?: boolean;
+    }): Promise<CoursePage<CourseSummaryView>>;
+    private courseSummary;
+    private choiceView;
+    /**
+     * Recorded auto-upgrade opt-in/out history of a course, in sequence order:
+     * every row (course and enrollment level), or with `enrollmentId` that
+     * enrollment's own rows plus the choice that currently governs it.
+     * Needs `read-draft` (authoring view); a foreign enrollment is a denial.
+     */
+    listUpgradeChoices(request: CourseAuthoringActor & CoursePageRequest & {
+        courseId: string;
+        enrollmentId?: string;
+    }): Promise<CoursePage<CourseUpgradeChoiceView> & {
+        governing: CourseUpgradeChoiceView | null;
+    }>;
+    /**
+     * Automatic upgrades that were not performed, oldest first, for a course
+     * and/or an enrollment (at least one is required). Needs `read-draft`.
+     */
+    listAutoUpgradeSkips(request: CourseAuthoringActor & CoursePageRequest & {
+        courseId?: string;
+        enrollmentId?: string;
+    }): Promise<CoursePage<AutoUpgradeSkipView>>;
+    /**
+     * Freezes one revision for assignment. Requires a current review of that exact
+     * revision from the injected gate; materializes immutable Course, section and
+     * Lesson rows for this release only.
+     */
+    release(request: CourseAuthoringActor & {
+        courseId: string;
+        revisionId: string;
+        requestKey: string;
+    }): Promise<CourseReleaseView>;
+    private materialize;
+    private releaseView;
+    /** Reversible; never touches enrollments, progress, submissions, grades or notes. */
+    archive(request: CourseAuthoringActor & {
+        courseId: string;
+        requestKey: string;
+    }): Promise<CourseStateView>;
+    unarchive(request: CourseAuthoringActor & {
+        courseId: string;
+        requestKey: string;
+    }): Promise<CourseStateView>;
+    private setArchived;
+    /**
+     * Discards a draft nothing references. History stays append-only: a tombstone
+     * ends the draft, and erasing its rows belongs to a retention operation.
+     */
+    discardDraft(request: CourseAuthoringActor & {
+        courseId: string;
+        requestKey: string;
+        reason?: string;
+    }): Promise<CourseStateView>;
+    private enrollmentRow;
+    private pins;
+    private releaseRow;
+    /** The opt-in/out row that governs an enrollment: its own, else the course's. */
+    private governingChoice;
+    private autoUpgradeEnabled;
+    private pinView;
+    private lockEnrollment;
+    private appendPin;
+    /**
+     * Records which release an existing enrollment follows. The enrollment must
+     * already have been created on that release's materialized Course row.
+     */
+    pinEnrollment(request: CourseAuthoringActor & {
+        enrollmentId: string;
+        releaseId: string;
+        requestKey: string;
+        /** Optional when the assign authorizer returns the basis. */
+        policyBasis?: string;
+    }): Promise<EnrollmentPinView>;
+    /** Explicit move of a pinned enrollment to a newer release of the same course. */
+    upgradeEnrollment(request: CourseAuthoringActor & {
+        enrollmentId: string;
+        releaseId: string;
+        requestKey: string;
+        /** Optional when the assign authorizer returns the basis. */
+        policyBasis?: string;
+    }): Promise<EnrollmentPinView>;
+    private movePin;
+    /**
+     * Records an opt-in or opt-out of auto-upgrade for a course (all its pinned
+     * enrollments) or one enrollment. It governs future releases only.
+     */
+    setAutoUpgrade(request: CourseAuthoringActor & {
+        courseId: string;
+        enrollmentId?: string;
+        enabled: boolean;
+        requestKey: string;
+        /** Optional when the assign authorizer returns the basis. */
+        policyBasis?: string;
+    }): Promise<SetAutoUpgradeResult>;
+    /**
+     * Re-evaluates, per enrollment, the recorded opt-in actor's current authority
+     * (and their delegating guardian's) for the `assign` action. Any denial or
+     * failure means "do not move"; it never blocks the release itself.
+     */
+    private authorizeAutoUpgrade;
+    /** Moves opted-in enrollments to a new release; each move is recorded. */
+    private autoUpgrade;
+    /**
+     * The enrollment's current release plus the lessons that apply to it. Started
+     * lessons stay on the immutable row they were started on after any move.
+     */
+    getEnrollmentRelease(request: CourseAuthoringActor & {
+        enrollmentId: string;
+    }): Promise<EnrollmentReleaseView>;
+}
+export {};
+//# sourceMappingURL=course-authoring-service.d.ts.map

package/dist/course-authoring-service.d.ts.map

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

package/dist/course-delegation.d.ts

@@ -0,0 +1,26 @@
+/** Longest accepted host delegation id and delegating-guardian user id. */
+export declare const MAX_DELEGATION_FIELD_LENGTH = 200;
+/** A validated delegated-agent claim: both members, never one without the other. */
+export interface CourseDelegation {
+    delegatingGuardianUserId: string;
+    delegationId: string;
+}
+type DelegationClaim = {
+    actorUserId?: unknown;
+    delegatingGuardianUserId?: unknown;
+    delegationId?: unknown;
+};
+/**
+ * Reads and validates the delegation members of a trusted actor. The delegation
+ * id and delegating guardian are validated as a unit, and the guardian can never
+ * be the acting agent. Returns null for an ordinary (non-delegated) actor.
+ * Passing validation grants nothing: the host authorizer and the guardian's live
+ * membership/relationship still decide.
+ */
+export declare function readDelegation(claim: DelegationClaim): CourseDelegation | null;
+/** Delegation members to spread into an actor or authorizer request (empty if none). */
+export declare function delegationActorFields(claim: DelegationClaim): Partial<CourseDelegation>;
+/** Delegation columns for a decision record; empty strings when not delegated. */
+export declare function delegationRecordFields(claim: DelegationClaim): CourseDelegation;
+export {};
+//# sourceMappingURL=course-delegation.d.ts.map

package/dist/course-delegation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"course-delegation.d.ts","sourceRoot":"","sources":["../src/course-delegation.ts"],"names":[],"mappings":"AAKA,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,KAAK,eAAe,GAAG;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAmBF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,GACrB,gBAAgB,GAAG,IAAI,CAgBzB;AAED,wFAAwF;AACxF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,GACrB,gBAAgB,CAIlB"}