@vived/app 6.2.0 → 6.3.0

package/dist/cjs/Procedure/Entities/ProcedureEntity.js

@@ -0,0 +1,279 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcedureEntity = void 0;
+exports.makeProcedureEntity = makeProcedureEntity;
+const core_1 = require("@vived/core");
+class ProcedureEntity extends core_1.AppObjectEntity {
+    constructor() {
+        super(...arguments);
+        this.challengeID = "PROCEDURE";
+        this.name = "Procedure";
+        this.authorHelpText = "Create step-by-step procedures by selecting events that users must emit.";
+    }
+}
+exports.ProcedureEntity = ProcedureEntity;
+ProcedureEntity.type = "ProcedureEntity";
+ProcedureEntity.get = (appObjects) => (0, core_1.getSingletonComponent)(ProcedureEntity.type, appObjects);
+function makeProcedureEntity(appObject) {
+    return new ProcedureEntityImp(appObject);
+}
+class ProcedureEntityImp extends ProcedureEntity {
+    get helpHeading() {
+        if (this._isQuiz)
+            return "Procedure Challenge";
+        else
+            return "Procedure Training";
+    }
+    get consumerHelpText() {
+        if (this._isQuiz)
+            return "Complete the procedure challenge on your own and get scored after submitting.";
+        else
+            return "Follow the steps in order to complete the training procedure.";
+    }
+    get eventIds() {
+        return [...this._eventIds];
+    }
+    get orderMatters() {
+        return this._orderMatters;
+    }
+    get showHints() {
+        return this._showHints;
+    }
+    get isQuiz() {
+        return this._isQuiz;
+    }
+    get userEventLog() {
+        return [...this._userEventLog];
+    }
+    get currentStepIndex() {
+        return this._currentStepIndex;
+    }
+    get isComplete() {
+        if (this._eventIds.length === 0)
+            return false;
+        if (this._orderMatters) {
+            return this._currentStepIndex >= this._eventIds.length;
+        }
+        else {
+            const requiredEvents = new Set(this._eventIds);
+            const emittedEvents = new Set(this._userEventLog);
+            return Array.from(requiredEvents).every((event) => emittedEvents.has(event));
+        }
+    }
+    get validationMessage() {
+        return this._validationMessage;
+    }
+    get score() {
+        return this._score;
+    }
+    get isSubmitted() {
+        return this._isSubmitted;
+    }
+    addEventId(eventId) {
+        if (this._eventIds.includes(eventId)) {
+            this._validationMessage = `Event '${eventId}' is already in the procedure`;
+            this.updateState();
+            return;
+        }
+        this._eventIds.push(eventId);
+        this._validationMessage = null;
+        this.updateState();
+    }
+    removeEventId(eventId) {
+        const index = this._eventIds.indexOf(eventId);
+        if (index === -1) {
+            this._validationMessage = `Event '${eventId}' is not in the procedure`;
+            this.updateState();
+            return;
+        }
+        this._eventIds.splice(index, 1);
+        this._validationMessage = null;
+        this.updateState();
+    }
+    clearEventIds() {
+        this._eventIds = [];
+        this._validationMessage = null;
+        this.updateState();
+    }
+    moveEventUp(index) {
+        if (index <= 0 || index >= this._eventIds.length) {
+            this._validationMessage = "Cannot move event up - invalid position";
+            this.updateState();
+            return;
+        }
+        const temp = this._eventIds[index];
+        this._eventIds[index] = this._eventIds[index - 1];
+        this._eventIds[index - 1] = temp;
+        this._validationMessage = null;
+        this.updateState();
+    }
+    moveEventDown(index) {
+        if (index < 0 || index >= this._eventIds.length - 1) {
+            this._validationMessage = "Cannot move event down - invalid position";
+            this.updateState();
+            return;
+        }
+        const temp = this._eventIds[index];
+        this._eventIds[index] = this._eventIds[index + 1];
+        this._eventIds[index + 1] = temp;
+        this._validationMessage = null;
+        this.updateState();
+    }
+    recordUserEvent(eventId) {
+        if (!this._eventIds.includes(eventId)) {
+            return;
+        }
+        this._userEventLog.push(eventId);
+        if (this._orderMatters) {
+            if (this._currentStepIndex < this._eventIds.length) {
+                const expectedEvent = this._eventIds[this._currentStepIndex];
+                if (eventId === expectedEvent) {
+                    this._currentStepIndex++;
+                    this._validationMessage = null;
+                }
+                else {
+                    this._validationMessage = `Expected '${expectedEvent}', but got '${eventId}'`;
+                }
+            }
+        }
+        this.updateState();
+    }
+    validateProgress() {
+        if (this._eventIds.length === 0) {
+            return "At least one event must be added to the procedure";
+        }
+        if (this.isComplete) {
+            return null;
+        }
+        if (this._orderMatters && this._validationMessage) {
+            return this._validationMessage;
+        }
+        return null;
+    }
+    getNextExpectedEvent() {
+        if (!this._showHints || this._eventIds.length === 0) {
+            return null;
+        }
+        if (this._orderMatters) {
+            if (this._currentStepIndex < this._eventIds.length) {
+                return this._eventIds[this._currentStepIndex];
+            }
+        }
+        else {
+            const emittedEvents = new Set(this._userEventLog);
+            return (this._eventIds.find((eventId) => !emittedEvents.has(eventId)) || null);
+        }
+        return null;
+    }
+    reset() {
+        this._userEventLog = [];
+        this._currentStepIndex = 0;
+        this._validationMessage = null;
+        this._score = null;
+        this._isSubmitted = false;
+        this.updateState();
+    }
+    setOrderMatters(orderMatters) {
+        this._orderMatters = orderMatters;
+        this.updateState();
+    }
+    setShowHints(showHints) {
+        this._showHints = showHints;
+        this.updateState();
+    }
+    setIsQuiz(isQuiz) {
+        this._isQuiz = isQuiz;
+        this.updateState();
+    }
+    getProgressPercentage() {
+        if (this._eventIds.length === 0)
+            return 0;
+        if (this._orderMatters) {
+            return Math.round((this._currentStepIndex / this._eventIds.length) * 100);
+        }
+        else {
+            const requiredEvents = new Set(this._eventIds);
+            const emittedEvents = new Set(this._userEventLog);
+            const completedCount = Array.from(requiredEvents).filter((event) => emittedEvents.has(event)).length;
+            return Math.round((completedCount / this._eventIds.length) * 100);
+        }
+    }
+    calculateScore() {
+        if (this._eventIds.length === 0) {
+            return { percentage: 0, comparison: [] };
+        }
+        const comparison = [];
+        let correctCount = 0;
+        if (this._orderMatters) {
+            for (let i = 0; i < this._eventIds.length; i++) {
+                const eventId = this._eventIds[i];
+                const expected = true;
+                const actual = i < this._userEventLog.length && this._userEventLog[i] === eventId;
+                const correct = actual;
+                comparison.push({ eventId, expected, actual, correct });
+                if (correct)
+                    correctCount++;
+            }
+        }
+        else {
+            const emittedEvents = new Set(this._userEventLog);
+            for (const eventId of this._eventIds) {
+                const expected = true;
+                const actual = emittedEvents.has(eventId);
+                const correct = actual;
+                comparison.push({ eventId, expected, actual, correct });
+                if (correct)
+                    correctCount++;
+            }
+        }
+        const percentage = Math.round((correctCount / this._eventIds.length) * 100);
+        return { percentage, comparison };
+    }
+    submit() {
+        if (!this._isQuiz) {
+            this._validationMessage = "Cannot submit: not in quiz mode";
+            this.updateState();
+            return;
+        }
+        this._score = this.calculateScore();
+        this._isSubmitted = true;
+        this._validationMessage = null;
+        this.updateState();
+    }
+    getAuthoringValidationMessage() {
+        if (this._eventIds.length === 0) {
+            return "At least one event must be added to the procedure";
+        }
+        return this._validationMessage;
+    }
+    updateState() {
+        const stateHash = JSON.stringify({
+            eventIds: this._eventIds,
+            orderMatters: this._orderMatters,
+            showHints: this._showHints,
+            isQuiz: this._isQuiz,
+            userEventLog: this._userEventLog,
+            currentStepIndex: this._currentStepIndex,
+            validationMessage: this._validationMessage,
+            score: this._score,
+            isSubmitted: this._isSubmitted,
+        });
+        this.memoizedState.val = stateHash;
+    }
+    constructor(appObject) {
+        super(appObject, ProcedureEntity.type);
+        this._eventIds = [];
+        this._orderMatters = true;
+        this._showHints = true;
+        this._isQuiz = false;
+        this._userEventLog = [];
+        this._currentStepIndex = 0;
+        this._validationMessage = null;
+        this._score = null;
+        this._isSubmitted = false;
+        this.memoizedState = new core_1.MemoizedString("", this.notifyOnChange);
+        this.appObjects.registerSingleton(this);
+        this.updateState();
+    }
+}
+//# sourceMappingURL=ProcedureEntity.js.map

package/dist/cjs/Procedure/Entities/ProcedureEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcedureEntity.js","sourceRoot":"","sources":["../../../../src/Procedure/Entities/ProcedureEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  AppObject,\r\n  AppObjectEntity,\r\n  AppObjectRepo,\r\n  getSingletonComponent,\r\n  MemoizedString,\r\n} from \"@vived/core\";\r\nimport { Challenge } from \"../../Challenge\";\r\n\r\nexport abstract class ProcedureEntity\r\n  extends AppObjectEntity\r\n  implements Challenge\r\n{\r\n  static readonly type = \"ProcedureEntity\";\r\n\r\n  readonly challengeID = \"PROCEDURE\";\r\n  name = \"Procedure\";\r\n  abstract get helpHeading(): string;\r\n  abstract get consumerHelpText(): string;\r\n  authorHelpText =\r\n    \"Create step-by-step procedures by selecting events that users must emit.\";\r\n\r\n  abstract get eventIds(): string[];\r\n  abstract get orderMatters(): boolean;\r\n  abstract get showHints(): boolean;\r\n  abstract get isQuiz(): boolean;\r\n  abstract get userEventLog(): string[];\r\n  abstract get currentStepIndex(): number;\r\n  abstract get isComplete(): boolean;\r\n  abstract get validationMessage(): string | null;\r\n  abstract get score(): {\r\n    percentage: number;\r\n    comparison: {eventId: string; expected: boolean; actual: boolean; correct: boolean}[];\r\n  } | null;\r\n  abstract get isSubmitted(): boolean;\r\n\r\n  abstract addEventId(eventId: string): void;\r\n  abstract removeEventId(eventId: string): void;\r\n  abstract clearEventIds(): void;\r\n  abstract recordUserEvent(eventId: string): void;\r\n  abstract validateProgress(): string | null;\r\n  abstract getNextExpectedEvent(): string | null;\r\n  abstract reset(): void;\r\n  abstract moveEventUp(index: number): void;\r\n  abstract moveEventDown(index: number): void;\r\n  abstract getAuthoringValidationMessage(): string | null;\r\n\r\n  abstract setOrderMatters(orderMatters: boolean): void;\r\n  abstract setShowHints(showHints: boolean): void;\r\n  abstract setIsQuiz(isQuiz: boolean): void;\r\n\r\n  abstract getProgressPercentage(): number;\r\n  abstract calculateScore(): {\r\n    percentage: number;\r\n    comparison: {eventId: string; expected: boolean; actual: boolean; correct: boolean}[];\r\n  };\r\n  abstract submit(): void;\r\n\r\n  static get = (appObjects: AppObjectRepo): ProcedureEntity | undefined =>\r\n    getSingletonComponent(ProcedureEntity.type, appObjects);\r\n}\r\n\r\nexport function makeProcedureEntity(appObject: AppObject): ProcedureEntity {\r\n  return new ProcedureEntityImp(appObject);\r\n}\r\n\r\nclass ProcedureEntityImp extends ProcedureEntity {\r\n  private _eventIds: string[] = [];\r\n  private _orderMatters = true;\r\n  private _showHints = true;\r\n  private _isQuiz = false;\r\n  private _userEventLog: string[] = [];\r\n  private _currentStepIndex = 0;\r\n  private _validationMessage: string | null = null;\r\n  private _score: {\r\n    percentage: number;\r\n    comparison: {eventId: string; expected: boolean; actual: boolean; correct: boolean}[];\r\n  } | null = null;\r\n  private _isSubmitted = false;\r\n\r\n  get helpHeading(): string {\r\n    if (this._isQuiz) return \"Procedure Challenge\";\r\n    else return \"Procedure Training\";\r\n  }\r\n\r\n  get consumerHelpText(): string {\r\n    if (this._isQuiz)\r\n      return \"Complete the procedure challenge on your own and get scored after submitting.\";\r\n    else return \"Follow the steps in order to complete the training procedure.\";\r\n  }\r\n\r\n  private memoizedState = new MemoizedString(\"\", this.notifyOnChange);\r\n\r\n  get eventIds(): string[] {\r\n    return [...this._eventIds];\r\n  }\r\n\r\n  get orderMatters(): boolean {\r\n    return this._orderMatters;\r\n  }\r\n\r\n  get showHints(): boolean {\r\n    return this._showHints;\r\n  }\r\n\r\n  get isQuiz(): boolean {\r\n    return this._isQuiz;\r\n  }\r\n\r\n  get userEventLog(): string[] {\r\n    return [...this._userEventLog];\r\n  }\r\n\r\n  get currentStepIndex(): number {\r\n    return this._currentStepIndex;\r\n  }\r\n\r\n  get isComplete(): boolean {\r\n    if (this._eventIds.length === 0) return false;\r\n\r\n    if (this._orderMatters) {\r\n      return this._currentStepIndex >= this._eventIds.length;\r\n    } else {\r\n      const requiredEvents = new Set(this._eventIds);\r\n      const emittedEvents = new Set(this._userEventLog);\r\n      return Array.from(requiredEvents).every((event) =>\r\n        emittedEvents.has(event),\r\n      );\r\n    }\r\n  }\r\n\r\n  get validationMessage(): string | null {\r\n    return this._validationMessage;\r\n  }\r\n\r\n  get score(): {\r\n    percentage: number;\r\n    comparison: {eventId: string; expected: boolean; actual: boolean; correct: boolean}[];\r\n  } | null {\r\n    return this._score;\r\n  }\r\n\r\n  get isSubmitted(): boolean {\r\n    return this._isSubmitted;\r\n  }\r\n\r\n  addEventId(eventId: string): void {\r\n    if (this._eventIds.includes(eventId)) {\r\n      this._validationMessage = `Event '${eventId}' is already in the procedure`;\r\n      this.updateState();\r\n      return;\r\n    }\r\n\r\n    this._eventIds.push(eventId);\r\n    this._validationMessage = null;\r\n    this.updateState();\r\n  }\r\n\r\n  removeEventId(eventId: string): void {\r\n    const index = this._eventIds.indexOf(eventId);\r\n    if (index === -1) {\r\n      this._validationMessage = `Event '${eventId}' is not in the procedure`;\r\n      this.updateState();\r\n      return;\r\n    }\r\n\r\n    this._eventIds.splice(index, 1);\r\n    this._validationMessage = null;\r\n    this.updateState();\r\n  }\r\n\r\n  clearEventIds(): void {\r\n    this._eventIds = [];\r\n    this._validationMessage = null;\r\n    this.updateState();\r\n  }\r\n\r\n  moveEventUp(index: number): void {\r\n    if (index <= 0 || index >= this._eventIds.length) {\r\n      this._validationMessage = \"Cannot move event up - invalid position\";\r\n      this.updateState();\r\n      return;\r\n    }\r\n\r\n    const temp = this._eventIds[index];\r\n    this._eventIds[index] = this._eventIds[index - 1];\r\n    this._eventIds[index - 1] = temp;\r\n\r\n    this._validationMessage = null;\r\n    this.updateState();\r\n  }\r\n\r\n  moveEventDown(index: number): void {\r\n    if (index < 0 || index >= this._eventIds.length - 1) {\r\n      this._validationMessage = \"Cannot move event down - invalid position\";\r\n      this.updateState();\r\n      return;\r\n    }\r\n\r\n    const temp = this._eventIds[index];\r\n    this._eventIds[index] = this._eventIds[index + 1];\r\n    this._eventIds[index + 1] = temp;\r\n\r\n    this._validationMessage = null;\r\n    this.updateState();\r\n  }\r\n\r\n  recordUserEvent(eventId: string): void {\r\n    if (!this._eventIds.includes(eventId)) {\r\n      return;\r\n    }\r\n\r\n    this._userEventLog.push(eventId);\r\n\r\n    if (this._orderMatters) {\r\n      if (this._currentStepIndex < this._eventIds.length) {\r\n        const expectedEvent = this._eventIds[this._currentStepIndex];\r\n        if (eventId === expectedEvent) {\r\n          this._currentStepIndex++;\r\n          this._validationMessage = null;\r\n        } else {\r\n          this._validationMessage = `Expected '${expectedEvent}', but got '${eventId}'`;\r\n        }\r\n      }\r\n    }\r\n\r\n    this.updateState();\r\n  }\r\n\r\n  validateProgress(): string | null {\r\n    if (this._eventIds.length === 0) {\r\n      return \"At least one event must be added to the procedure\";\r\n    }\r\n\r\n    if (this.isComplete) {\r\n      return null;\r\n    }\r\n\r\n    if (this._orderMatters && this._validationMessage) {\r\n      return this._validationMessage;\r\n    }\r\n\r\n    return null;\r\n  }\r\n\r\n  getNextExpectedEvent(): string | null {\r\n    if (!this._showHints || this._eventIds.length === 0) {\r\n      return null;\r\n    }\r\n\r\n    if (this._orderMatters) {\r\n      if (this._currentStepIndex < this._eventIds.length) {\r\n        return this._eventIds[this._currentStepIndex];\r\n      }\r\n    } else {\r\n      const emittedEvents = new Set(this._userEventLog);\r\n      return (\r\n        this._eventIds.find((eventId) => !emittedEvents.has(eventId)) || null\r\n      );\r\n    }\r\n\r\n    return null;\r\n  }\r\n\r\n  reset(): void {\r\n    this._userEventLog = [];\r\n    this._currentStepIndex = 0;\r\n    this._validationMessage = null;\r\n    this._score = null;\r\n    this._isSubmitted = false;\r\n    this.updateState();\r\n  }\r\n\r\n  setOrderMatters(orderMatters: boolean): void {\r\n    this._orderMatters = orderMatters;\r\n    this.updateState();\r\n  }\r\n\r\n  setShowHints(showHints: boolean): void {\r\n    this._showHints = showHints;\r\n    this.updateState();\r\n  }\r\n\r\n  setIsQuiz(isQuiz: boolean): void {\r\n    this._isQuiz = isQuiz;\r\n    this.updateState();\r\n  }\r\n\r\n  getProgressPercentage(): number {\r\n    if (this._eventIds.length === 0) return 0;\r\n\r\n    if (this._orderMatters) {\r\n      return Math.round((this._currentStepIndex / this._eventIds.length) * 100);\r\n    } else {\r\n      const requiredEvents = new Set(this._eventIds);\r\n      const emittedEvents = new Set(this._userEventLog);\r\n      const completedCount = Array.from(requiredEvents).filter((event) =>\r\n        emittedEvents.has(event),\r\n      ).length;\r\n      return Math.round((completedCount / this._eventIds.length) * 100);\r\n    }\r\n  }\r\n\r\n  calculateScore(): {\r\n    percentage: number;\r\n    comparison: {eventId: string; expected: boolean; actual: boolean; correct: boolean}[];\r\n  } {\r\n    if (this._eventIds.length === 0) {\r\n      return { percentage: 0, comparison: [] };\r\n    }\r\n\r\n    const comparison: {eventId: string; expected: boolean; actual: boolean; correct: boolean}[] = [];\r\n    let correctCount = 0;\r\n\r\n    if (this._orderMatters) {\r\n      for (let i = 0; i < this._eventIds.length; i++) {\r\n        const eventId = this._eventIds[i];\r\n        const expected = true;\r\n        const actual =\r\n          i < this._userEventLog.length && this._userEventLog[i] === eventId;\r\n        const correct = actual;\r\n\r\n        comparison.push({ eventId, expected, actual, correct });\r\n        if (correct) correctCount++;\r\n      }\r\n    } else {\r\n      const emittedEvents = new Set(this._userEventLog);\r\n      for (const eventId of this._eventIds) {\r\n        const expected = true;\r\n        const actual = emittedEvents.has(eventId);\r\n        const correct = actual;\r\n\r\n        comparison.push({ eventId, expected, actual, correct });\r\n        if (correct) correctCount++;\r\n      }\r\n    }\r\n\r\n    const percentage = Math.round(\r\n      (correctCount / this._eventIds.length) * 100,\r\n    );\r\n    return { percentage, comparison };\r\n  }\r\n\r\n  submit(): void {\r\n    if (!this._isQuiz) {\r\n      this._validationMessage = \"Cannot submit: not in quiz mode\";\r\n      this.updateState();\r\n      return;\r\n    }\r\n\r\n    this._score = this.calculateScore();\r\n    this._isSubmitted = true;\r\n    this._validationMessage = null;\r\n    this.updateState();\r\n  }\r\n\r\n  getAuthoringValidationMessage(): string | null {\r\n    if (this._eventIds.length === 0) {\r\n      return \"At least one event must be added to the procedure\";\r\n    }\r\n    return this._validationMessage;\r\n  }\r\n\r\n  private updateState(): void {\r\n    const stateHash = JSON.stringify({\r\n      eventIds: this._eventIds,\r\n      orderMatters: this._orderMatters,\r\n      showHints: this._showHints,\r\n      isQuiz: this._isQuiz,\r\n      userEventLog: this._userEventLog,\r\n      currentStepIndex: this._currentStepIndex,\r\n      validationMessage: this._validationMessage,\r\n      score: this._score,\r\n      isSubmitted: this._isSubmitted,\r\n    });\r\n\r\n    this.memoizedState.val = stateHash;\r\n  }\r\n\r\n  constructor(appObject: AppObject) {\r\n    super(appObject, ProcedureEntity.type);\r\n    this.appObjects.registerSingleton(this);\r\n    this.updateState();\r\n  }\r\n}\r\n"]}

package/dist/cjs/Procedure/Entities/ProcedureEntity.test.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@vived/core");
+const ProcedureEntity_1 = require("./ProcedureEntity");
+describe("ProcedureEntity", () => {
+    let appObjects;
+    let procedureEntity;
+    beforeEach(() => {
+        appObjects = (0, core_1.makeAppObjectRepo)();
+        const appObject = appObjects.getOrCreate("TestProcedure");
+        procedureEntity = (0, ProcedureEntity_1.makeProcedureEntity)(appObject);
+    });
+    it("implements Challenge interface correctly", () => {
+        expect(procedureEntity.challengeID).toBe("PROCEDURE");
+        expect(procedureEntity.name).toBe("Procedure");
+        expect(typeof procedureEntity.consumerHelpText).toBe("string");
+        expect(typeof procedureEntity.authorHelpText).toBe("string");
+        expect(typeof procedureEntity.reset).toBe("function");
+    });
+    it("has dynamic helpHeading based on quiz mode", () => {
+        expect(procedureEntity.helpHeading).toBe("Procedure Training");
+        procedureEntity.setIsQuiz(true);
+        expect(procedureEntity.helpHeading).toBe("Procedure Challenge");
+        procedureEntity.setIsQuiz(false);
+        expect(procedureEntity.helpHeading).toBe("Procedure Training");
+    });
+    it("has dynamic consumerHelpText based on quiz mode", () => {
+        expect(procedureEntity.consumerHelpText).toBe("Follow the steps in order to complete the training procedure.");
+        procedureEntity.setIsQuiz(true);
+        expect(procedureEntity.consumerHelpText).toBe("Complete the procedure challenge on your own and get scored after submitting.");
+        procedureEntity.setIsQuiz(false);
+        expect(procedureEntity.consumerHelpText).toBe("Follow the steps in order to complete the training procedure.");
+    });
+    it("has correct singleton registration", () => {
+        const retrieved = ProcedureEntity_1.ProcedureEntity.get(appObjects);
+        expect(retrieved).toBe(procedureEntity);
+    });
+    it("starts with empty event list", () => {
+        expect(procedureEntity.eventIds).toEqual([]);
+    });
+    it("can add events to procedure", () => {
+        procedureEntity.addEventId("test_event_1");
+        procedureEntity.addEventId("test_event_2");
+        expect(procedureEntity.eventIds).toEqual(["test_event_1", "test_event_2"]);
+    });
+    it("prevents duplicate events", () => {
+        procedureEntity.addEventId("test_event");
+        procedureEntity.addEventId("test_event");
+        expect(procedureEntity.eventIds).toEqual(["test_event"]);
+        expect(procedureEntity.validationMessage).toContain("already in the procedure");
+    });
+    it("can remove events from procedure", () => {
+        procedureEntity.addEventId("test_event_1");
+        procedureEntity.addEventId("test_event_2");
+        procedureEntity.removeEventId("test_event_1");
+        expect(procedureEntity.eventIds).toEqual(["test_event_2"]);
+    });
+    it("handles removing non-existent events", () => {
+        procedureEntity.removeEventId("non_existent");
+        expect(procedureEntity.validationMessage).toContain("not in the procedure");
+    });
+    it("can clear all events", () => {
+        procedureEntity.addEventId("test_event_1");
+        procedureEntity.addEventId("test_event_2");
+        procedureEntity.clearEventIds();
+        expect(procedureEntity.eventIds).toEqual([]);
+    });
+    it("starts with empty user event log", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.addEventId("event_3");
+        expect(procedureEntity.userEventLog).toEqual([]);
+        expect(procedureEntity.currentStepIndex).toBe(0);
+        expect(procedureEntity.isComplete).toBe(false);
+    });
+    it("records user events for ordered procedures", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.addEventId("event_3");
+        procedureEntity.setOrderMatters(true);
+        procedureEntity.recordUserEvent("event_1");
+        expect(procedureEntity.userEventLog).toEqual(["event_1"]);
+        expect(procedureEntity.currentStepIndex).toBe(1);
+        procedureEntity.recordUserEvent("event_2");
+        expect(procedureEntity.currentStepIndex).toBe(2);
+    });
+    it("validates order in ordered procedures", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.addEventId("event_3");
+        procedureEntity.setOrderMatters(true);
+        procedureEntity.recordUserEvent("event_2");
+        expect(procedureEntity.validationMessage).toContain("Expected 'event_1', but got 'event_2'");
+        expect(procedureEntity.currentStepIndex).toBe(0);
+    });
+    it("ignores order in unordered procedures", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.addEventId("event_3");
+        procedureEntity.setOrderMatters(false);
+        procedureEntity.recordUserEvent("event_3");
+        procedureEntity.recordUserEvent("event_1");
+        expect(procedureEntity.userEventLog).toEqual(["event_3", "event_1"]);
+    });
+    it("ignores events not in procedure", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.addEventId("event_3");
+        procedureEntity.recordUserEvent("unknown_event");
+        expect(procedureEntity.userEventLog).toEqual([]);
+    });
+    it("detects completion in ordered procedures", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.setOrderMatters(true);
+        expect(procedureEntity.isComplete).toBe(false);
+        procedureEntity.recordUserEvent("event_1");
+        expect(procedureEntity.isComplete).toBe(false);
+        procedureEntity.recordUserEvent("event_2");
+        expect(procedureEntity.isComplete).toBe(true);
+    });
+    it("detects completion in unordered procedures", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.setOrderMatters(false);
+        expect(procedureEntity.isComplete).toBe(false);
+        procedureEntity.recordUserEvent("event_2");
+        expect(procedureEntity.isComplete).toBe(false);
+        procedureEntity.recordUserEvent("event_1");
+        expect(procedureEntity.isComplete).toBe(true);
+    });
+    it("returns false for empty procedures", () => {
+        procedureEntity.clearEventIds();
+        expect(procedureEntity.isComplete).toBe(false);
+    });
+    it("calculates progress for ordered procedures", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.addEventId("event_3");
+        procedureEntity.addEventId("event_4");
+        procedureEntity.setOrderMatters(true);
+        expect(procedureEntity.getProgressPercentage()).toBe(0);
+        procedureEntity.recordUserEvent("event_1");
+        expect(procedureEntity.getProgressPercentage()).toBe(25);
+        procedureEntity.recordUserEvent("event_2");
+        expect(procedureEntity.getProgressPercentage()).toBe(50);
+        procedureEntity.recordUserEvent("event_3");
+        procedureEntity.recordUserEvent("event_4");
+        expect(procedureEntity.getProgressPercentage()).toBe(100);
+    });
+    it("calculates progress for unordered procedures", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.addEventId("event_3");
+        procedureEntity.addEventId("event_4");
+        procedureEntity.setOrderMatters(false);
+        expect(procedureEntity.getProgressPercentage()).toBe(0);
+        procedureEntity.recordUserEvent("event_3");
+        expect(procedureEntity.getProgressPercentage()).toBe(25);
+        procedureEntity.recordUserEvent("event_1");
+        expect(procedureEntity.getProgressPercentage()).toBe(50);
+    });
+    it("provides next expected event for ordered procedures with hints enabled", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.addEventId("event_3");
+        procedureEntity.setOrderMatters(true);
+        procedureEntity.setShowHints(true);
+        expect(procedureEntity.getNextExpectedEvent()).toBe("event_1");
+        procedureEntity.recordUserEvent("event_1");
+        expect(procedureEntity.getNextExpectedEvent()).toBe("event_2");
+    });
+    it("provides next unemitted event for unordered procedures with hints enabled", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.addEventId("event_3");
+        procedureEntity.setOrderMatters(false);
+        procedureEntity.setShowHints(true);
+        expect(procedureEntity.getNextExpectedEvent()).toBe("event_1");
+        procedureEntity.recordUserEvent("event_3");
+        expect(procedureEntity.getNextExpectedEvent()).toBe("event_1");
+        procedureEntity.recordUserEvent("event_1");
+        expect(procedureEntity.getNextExpectedEvent()).toBe("event_2");
+    });
+    it("returns null when hints are disabled", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.setShowHints(false);
+        expect(procedureEntity.getNextExpectedEvent()).toBe(null);
+    });
+    it("can toggle order matters setting", () => {
+        expect(procedureEntity.orderMatters).toBe(true);
+        procedureEntity.setOrderMatters(false);
+        expect(procedureEntity.orderMatters).toBe(false);
+    });
+    it("can toggle hints setting", () => {
+        expect(procedureEntity.showHints).toBe(true);
+        procedureEntity.setShowHints(false);
+        expect(procedureEntity.showHints).toBe(false);
+    });
+    it("can toggle quiz mode", () => {
+        expect(procedureEntity.isQuiz).toBe(false);
+        procedureEntity.setIsQuiz(true);
+        expect(procedureEntity.isQuiz).toBe(true);
+    });
+    it("resets user progress while preserving configuration", () => {
+        procedureEntity.addEventId("event_1");
+        procedureEntity.addEventId("event_2");
+        procedureEntity.setOrderMatters(false);
+        procedureEntity.setShowHints(false);
+        procedureEntity.setIsQuiz(true);
+        procedureEntity.recordUserEvent("event_1");
+        expect(procedureEntity.userEventLog.length).toBe(1);
+        procedureEntity.reset();
+        expect(procedureEntity.userEventLog).toEqual([]);
+        expect(procedureEntity.currentStepIndex).toBe(0);
+        expect(procedureEntity.validationMessage).toBe(null);
+        expect(procedureEntity.eventIds).toEqual(["event_1", "event_2"]);
+        expect(procedureEntity.orderMatters).toBe(false);
+        expect(procedureEntity.showHints).toBe(false);
+        expect(procedureEntity.isQuiz).toBe(true);
+    });
+});
+//# sourceMappingURL=ProcedureEntity.test.js.map

package/dist/cjs/Procedure/Entities/ProcedureEntity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcedureEntity.test.js","sourceRoot":"","sources":["../../../../src/Procedure/Entities/ProcedureEntity.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppObjectRepo, makeAppObjectRepo } from \"@vived/core\";\r\nimport { ProcedureEntity, makeProcedureEntity } from \"./ProcedureEntity\";\r\n\r\ndescribe(\"ProcedureEntity\", () => {\r\n\tlet appObjects: AppObjectRepo;\r\n\tlet procedureEntity: ProcedureEntity;\r\n\r\n\tbeforeEach(() => {\r\n\t\tappObjects = makeAppObjectRepo();\r\n\t\tconst appObject = appObjects.getOrCreate(\"TestProcedure\");\r\n\t\tprocedureEntity = makeProcedureEntity(appObject);\r\n\t});\r\n\r\n\tit(\"implements Challenge interface correctly\", () => {\r\n\t\texpect(procedureEntity.challengeID).toBe(\"PROCEDURE\");\r\n\t\texpect(procedureEntity.name).toBe(\"Procedure\");\r\n\t\texpect(typeof procedureEntity.consumerHelpText).toBe(\"string\");\r\n\t\texpect(typeof procedureEntity.authorHelpText).toBe(\"string\");\r\n\t\texpect(typeof procedureEntity.reset).toBe(\"function\");\r\n\t});\r\n\r\n\tit(\"has dynamic helpHeading based on quiz mode\", () => {\r\n\t\texpect(procedureEntity.helpHeading).toBe(\"Procedure Training\");\r\n\t\tprocedureEntity.setIsQuiz(true);\r\n\t\texpect(procedureEntity.helpHeading).toBe(\"Procedure Challenge\");\r\n\t\tprocedureEntity.setIsQuiz(false);\r\n\t\texpect(procedureEntity.helpHeading).toBe(\"Procedure Training\");\r\n\t});\r\n\r\n\tit(\"has dynamic consumerHelpText based on quiz mode\", () => {\r\n\t\texpect(procedureEntity.consumerHelpText).toBe(\r\n\t\t\t\"Follow the steps in order to complete the training procedure.\",\r\n\t\t);\r\n\t\tprocedureEntity.setIsQuiz(true);\r\n\t\texpect(procedureEntity.consumerHelpText).toBe(\r\n\t\t\t\"Complete the procedure challenge on your own and get scored after submitting.\",\r\n\t\t);\r\n\t\tprocedureEntity.setIsQuiz(false);\r\n\t\texpect(procedureEntity.consumerHelpText).toBe(\r\n\t\t\t\"Follow the steps in order to complete the training procedure.\",\r\n\t\t);\r\n\t});\r\n\r\n\tit(\"has correct singleton registration\", () => {\r\n\t\tconst retrieved = ProcedureEntity.get(appObjects);\r\n\t\texpect(retrieved).toBe(procedureEntity);\r\n\t});\r\n\r\n\tit(\"starts with empty event list\", () => {\r\n\t\texpect(procedureEntity.eventIds).toEqual([]);\r\n\t});\r\n\r\n\tit(\"can add events to procedure\", () => {\r\n\t\tprocedureEntity.addEventId(\"test_event_1\");\r\n\t\tprocedureEntity.addEventId(\"test_event_2\");\r\n\t\texpect(procedureEntity.eventIds).toEqual([\"test_event_1\", \"test_event_2\"]);\r\n\t});\r\n\r\n\tit(\"prevents duplicate events\", () => {\r\n\t\tprocedureEntity.addEventId(\"test_event\");\r\n\t\tprocedureEntity.addEventId(\"test_event\");\r\n\t\texpect(procedureEntity.eventIds).toEqual([\"test_event\"]);\r\n\t\texpect(procedureEntity.validationMessage).toContain(\"already in the procedure\");\r\n\t});\r\n\r\n\tit(\"can remove events from procedure\", () => {\r\n\t\tprocedureEntity.addEventId(\"test_event_1\");\r\n\t\tprocedureEntity.addEventId(\"test_event_2\");\r\n\t\tprocedureEntity.removeEventId(\"test_event_1\");\r\n\t\texpect(procedureEntity.eventIds).toEqual([\"test_event_2\"]);\r\n\t});\r\n\r\n\tit(\"handles removing non-existent events\", () => {\r\n\t\tprocedureEntity.removeEventId(\"non_existent\");\r\n\t\texpect(procedureEntity.validationMessage).toContain(\"not in the procedure\");\r\n\t});\r\n\r\n\tit(\"can clear all events\", () => {\r\n\t\tprocedureEntity.addEventId(\"test_event_1\");\r\n\t\tprocedureEntity.addEventId(\"test_event_2\");\r\n\t\tprocedureEntity.clearEventIds();\r\n\t\texpect(procedureEntity.eventIds).toEqual([]);\r\n\t});\r\n\r\n\tit(\"starts with empty user event log\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.addEventId(\"event_3\");\r\n\t\texpect(procedureEntity.userEventLog).toEqual([]);\r\n\t\texpect(procedureEntity.currentStepIndex).toBe(0);\r\n\t\texpect(procedureEntity.isComplete).toBe(false);\r\n\t});\r\n\r\n\tit(\"records user events for ordered procedures\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.addEventId(\"event_3\");\r\n\t\tprocedureEntity.setOrderMatters(true);\r\n\t\tprocedureEntity.recordUserEvent(\"event_1\");\r\n\t\texpect(procedureEntity.userEventLog).toEqual([\"event_1\"]);\r\n\t\texpect(procedureEntity.currentStepIndex).toBe(1);\r\n\t\tprocedureEntity.recordUserEvent(\"event_2\");\r\n\t\texpect(procedureEntity.currentStepIndex).toBe(2);\r\n\t});\r\n\r\n\tit(\"validates order in ordered procedures\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.addEventId(\"event_3\");\r\n\t\tprocedureEntity.setOrderMatters(true);\r\n\t\tprocedureEntity.recordUserEvent(\"event_2\");\r\n\t\texpect(procedureEntity.validationMessage).toContain(\r\n\t\t\t\"Expected 'event_1', but got 'event_2'\",\r\n\t\t);\r\n\t\texpect(procedureEntity.currentStepIndex).toBe(0);\r\n\t});\r\n\r\n\tit(\"ignores order in unordered procedures\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.addEventId(\"event_3\");\r\n\t\tprocedureEntity.setOrderMatters(false);\r\n\t\tprocedureEntity.recordUserEvent(\"event_3\");\r\n\t\tprocedureEntity.recordUserEvent(\"event_1\");\r\n\t\texpect(procedureEntity.userEventLog).toEqual([\"event_3\", \"event_1\"]);\r\n\t});\r\n\r\n\tit(\"ignores events not in procedure\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.addEventId(\"event_3\");\r\n\t\tprocedureEntity.recordUserEvent(\"unknown_event\");\r\n\t\texpect(procedureEntity.userEventLog).toEqual([]);\r\n\t});\r\n\r\n\tit(\"detects completion in ordered procedures\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.setOrderMatters(true);\r\n\t\texpect(procedureEntity.isComplete).toBe(false);\r\n\t\tprocedureEntity.recordUserEvent(\"event_1\");\r\n\t\texpect(procedureEntity.isComplete).toBe(false);\r\n\t\tprocedureEntity.recordUserEvent(\"event_2\");\r\n\t\texpect(procedureEntity.isComplete).toBe(true);\r\n\t});\r\n\r\n\tit(\"detects completion in unordered procedures\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.setOrderMatters(false);\r\n\t\texpect(procedureEntity.isComplete).toBe(false);\r\n\t\tprocedureEntity.recordUserEvent(\"event_2\");\r\n\t\texpect(procedureEntity.isComplete).toBe(false);\r\n\t\tprocedureEntity.recordUserEvent(\"event_1\");\r\n\t\texpect(procedureEntity.isComplete).toBe(true);\r\n\t});\r\n\r\n\tit(\"returns false for empty procedures\", () => {\r\n\t\tprocedureEntity.clearEventIds();\r\n\t\texpect(procedureEntity.isComplete).toBe(false);\r\n\t});\r\n\r\n\tit(\"calculates progress for ordered procedures\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.addEventId(\"event_3\");\r\n\t\tprocedureEntity.addEventId(\"event_4\");\r\n\t\tprocedureEntity.setOrderMatters(true);\r\n\t\texpect(procedureEntity.getProgressPercentage()).toBe(0);\r\n\t\tprocedureEntity.recordUserEvent(\"event_1\");\r\n\t\texpect(procedureEntity.getProgressPercentage()).toBe(25);\r\n\t\tprocedureEntity.recordUserEvent(\"event_2\");\r\n\t\texpect(procedureEntity.getProgressPercentage()).toBe(50);\r\n\t\tprocedureEntity.recordUserEvent(\"event_3\");\r\n\t\tprocedureEntity.recordUserEvent(\"event_4\");\r\n\t\texpect(procedureEntity.getProgressPercentage()).toBe(100);\r\n\t});\r\n\r\n\tit(\"calculates progress for unordered procedures\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.addEventId(\"event_3\");\r\n\t\tprocedureEntity.addEventId(\"event_4\");\r\n\t\tprocedureEntity.setOrderMatters(false);\r\n\t\texpect(procedureEntity.getProgressPercentage()).toBe(0);\r\n\t\tprocedureEntity.recordUserEvent(\"event_3\");\r\n\t\texpect(procedureEntity.getProgressPercentage()).toBe(25);\r\n\t\tprocedureEntity.recordUserEvent(\"event_1\");\r\n\t\texpect(procedureEntity.getProgressPercentage()).toBe(50);\r\n\t});\r\n\r\n\tit(\"provides next expected event for ordered procedures with hints enabled\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.addEventId(\"event_3\");\r\n\t\tprocedureEntity.setOrderMatters(true);\r\n\t\tprocedureEntity.setShowHints(true);\r\n\t\texpect(procedureEntity.getNextExpectedEvent()).toBe(\"event_1\");\r\n\t\tprocedureEntity.recordUserEvent(\"event_1\");\r\n\t\texpect(procedureEntity.getNextExpectedEvent()).toBe(\"event_2\");\r\n\t});\r\n\r\n\tit(\"provides next unemitted event for unordered procedures with hints enabled\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.addEventId(\"event_3\");\r\n\t\tprocedureEntity.setOrderMatters(false);\r\n\t\tprocedureEntity.setShowHints(true);\r\n\t\texpect(procedureEntity.getNextExpectedEvent()).toBe(\"event_1\");\r\n\t\tprocedureEntity.recordUserEvent(\"event_3\");\r\n\t\texpect(procedureEntity.getNextExpectedEvent()).toBe(\"event_1\");\r\n\t\tprocedureEntity.recordUserEvent(\"event_1\");\r\n\t\texpect(procedureEntity.getNextExpectedEvent()).toBe(\"event_2\");\r\n\t});\r\n\r\n\tit(\"returns null when hints are disabled\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.setShowHints(false);\r\n\t\texpect(procedureEntity.getNextExpectedEvent()).toBe(null);\r\n\t});\r\n\r\n\tit(\"can toggle order matters setting\", () => {\r\n\t\texpect(procedureEntity.orderMatters).toBe(true);\r\n\t\tprocedureEntity.setOrderMatters(false);\r\n\t\texpect(procedureEntity.orderMatters).toBe(false);\r\n\t});\r\n\r\n\tit(\"can toggle hints setting\", () => {\r\n\t\texpect(procedureEntity.showHints).toBe(true);\r\n\t\tprocedureEntity.setShowHints(false);\r\n\t\texpect(procedureEntity.showHints).toBe(false);\r\n\t});\r\n\r\n\tit(\"can toggle quiz mode\", () => {\r\n\t\texpect(procedureEntity.isQuiz).toBe(false);\r\n\t\tprocedureEntity.setIsQuiz(true);\r\n\t\texpect(procedureEntity.isQuiz).toBe(true);\r\n\t});\r\n\r\n\tit(\"resets user progress while preserving configuration\", () => {\r\n\t\tprocedureEntity.addEventId(\"event_1\");\r\n\t\tprocedureEntity.addEventId(\"event_2\");\r\n\t\tprocedureEntity.setOrderMatters(false);\r\n\t\tprocedureEntity.setShowHints(false);\r\n\t\tprocedureEntity.setIsQuiz(true);\r\n\t\tprocedureEntity.recordUserEvent(\"event_1\");\r\n\t\texpect(procedureEntity.userEventLog.length).toBe(1);\r\n\t\tprocedureEntity.reset();\r\n\t\texpect(procedureEntity.userEventLog).toEqual([]);\r\n\t\texpect(procedureEntity.currentStepIndex).toBe(0);\r\n\t\texpect(procedureEntity.validationMessage).toBe(null);\r\n\t\texpect(procedureEntity.eventIds).toEqual([\"event_1\", \"event_2\"]);\r\n\t\texpect(procedureEntity.orderMatters).toBe(false);\r\n\t\texpect(procedureEntity.showHints).toBe(false);\r\n\t\texpect(procedureEntity.isQuiz).toBe(true);\r\n\t});\r\n});\r\n"]}

package/dist/cjs/Procedure/Entities/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ProcedureEntity"), exports);
+__exportStar(require("./HintRegistry"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/Procedure/Entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Procedure/Entities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,iDAA+B","sourcesContent":["export * from \"./ProcedureEntity\";\r\nexport * from \"./HintRegistry\";\r\n"]}