@innovatorstack/harness 0.0.0-stage → 0.1.1

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/diagnostics/source-location.d.ts

@@ -0,0 +1,7 @@
+export interface SourceLocation {
+    readonly file: string;
+    readonly line: number;
+    readonly column: number;
+    readonly path: string;
+}
+//# sourceMappingURL=source-location.d.ts.map

package/dist/diagnostics/source-location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-location.d.ts","sourceRoot":"","sources":["../../src/diagnostics/source-location.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB"}

package/dist/diagnostics/source-location.js

@@ -0,0 +1 @@
+//# sourceMappingURL=source-location.js.map

package/dist/diagnostics/source-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-location.js","sourceRoot":"","sources":["../../src/diagnostics/source-location.ts"],"names":[],"mappings":""}

package/dist/engine/instance.d.ts

@@ -0,0 +1,57 @@
+import type { ClockControl } from "../controls/clock.js";
+import type { FailureInjection, InjectedFailureHandle } from "../controls/failure-types.js";
+import type { ExecutionObserver, Observation } from "../controls/observers.js";
+import type { StateReader } from "../controls/state.js";
+import type { ValuePosition, ValueSettings } from "../controls/values.js";
+import type { Runtime } from "../core/runtime.js";
+import type { HarnessModule } from "../core/types.js";
+import type { ExecutionReport } from "../instrumentation/types.js";
+import type { Item } from "../items/item.js";
+import type { PackageLoadReport } from "../packages/importer.js";
+import type { AmlDocument } from "../packages/types.js";
+import type { PlatformOptions } from "../platform/engine.js";
+import type { PlatformTraceEvent } from "../platform/trace.js";
+import type { ItemReference, SeedValue } from "../platform/values.js";
+import type { HarnessStorage, StorageValue, StoredItem } from "../storage/types.js";
+export interface EngineOptions extends PlatformOptions, ValueSettings {
+    readonly database?: string;
+    readonly storage?: HarnessStorage;
+    readonly modules?: readonly HarnessModule[];
+}
+export interface Engine {
+    readonly state: StateReader;
+    readonly clock: ClockControl;
+    observe(callback: ExecutionObserver): Observation;
+    injectFailure(injection: FailureInjection): InjectedFailureHandle;
+    readonly runtime: Runtime;
+    readonly storage: HarnessStorage;
+    readonly trace: readonly PlatformTraceEvent[];
+    readonly executions: readonly ExecutionReport[];
+    clearExecutions(): void;
+    seed(type: string, properties: Readonly<Record<string, SeedValue>>): ItemReference;
+    inspect(reference: ItemReference): StoredItem;
+    find(type: string, properties: Readonly<Record<string, StorageValue>>): ItemReference;
+    item(reference: ItemReference, action?: string): Item;
+    apply(item: Item): Promise<Item>;
+    applyAML(xml: string): Promise<Item>;
+    callMethod(name: string, context: Item): Promise<Item>;
+    loadPackages(paths: readonly string[]): Promise<PackageLoadReport>;
+    checkpoint(): void;
+    reset(): void;
+    close(): void;
+    [Symbol.dispose](): void;
+}
+interface InitialSetup {
+    readonly packages: readonly AmlDocument[];
+    readonly fixtures: readonly AmlDocument[];
+}
+export interface EngineImage {
+    readonly database: Uint8Array;
+    readonly values: ValuePosition;
+}
+/** Only configured setup captures this image, before the world is returned to application code. */
+export declare function captureEngine(engine: Engine): EngineImage;
+/** Both entry points initialize exactly once, before exposing a usable world. */
+export declare function openEngine(options: EngineOptions, setup?: InitialSetup | EngineImage): Engine;
+export {};
+//# sourceMappingURL=instance.d.ts.map

package/dist/engine/instance.d.ts.map

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

package/dist/engine/instance.js

@@ -0,0 +1,281 @@
+import { builtinDatabase } from "../baseline/database.js";
+import { createStateReader } from "../controls/state.js";
+import { WorldControls } from "../controls/world.js";
+import { RuntimeError } from "../core/errors.js";
+import { createRuntime } from "../core/runtime.js";
+import { createFixtureModule } from "../fixtures/module.js";
+import { loadAmlDocuments } from "../packages/files.js";
+import { createPackageModule, importPackageDocuments, importSetupDocuments, } from "../packages/module.js";
+import { withImportBaseline } from "../packages/state.js";
+import { Platform, applyItemOperation, applyAMLOperation, callMethodOperation, seedOperation, } from "../platform/engine.js";
+import { ApplicationError } from "../platform/errors.js";
+import { PlatformTrace } from "../platform/trace.js";
+import { selectQuery } from "../queries/types.js";
+import { SqliteStorage } from "../storage/sqlite/storage.js";
+import { setCheckpoint, restoreCheckpoint, retainCheckpoint, } from "../storage/sqlite/transactions.js";
+/** Only configured setup captures this image, before the world is returned to application code. */
+export function captureEngine(engine) {
+    if (!(engine instanceof HarnessInstance)) {
+        throw new TypeError("Only an owned Harness engine can capture its setup image.");
+    }
+    return engine.capture();
+}
+/** Both entry points initialize exactly once, before exposing a usable world. */
+export function openEngine(options, setup) {
+    if (options.database !== undefined && options.storage !== undefined) {
+        throw new TypeError("Supply a database path or a storage implementation, not both.");
+    }
+    if (options.ids !== undefined && options.nextId !== undefined) {
+        throw new TypeError("Supply seeded IDs or nextId, not both.");
+    }
+    const storage = options.storage ?? new SqliteStorage(options.database);
+    let runtime;
+    try {
+        const controls = new WorldControls(storage, options);
+        const useBuiltin = (options.modules?.length ?? 0) === 0 &&
+            (setup
+                ? !("database" in setup)
+                : options.storage === undefined && options.database === undefined);
+        if (setup && "database" in setup) {
+            storage.restore(setup.database);
+            controls.values.restore(setup.values);
+        }
+        else if (useBuiltin) {
+            storage.restore(builtinDatabase());
+        }
+        const platform = new Platform(storage, { ...options, nextId: options.nextId ?? (() => controls.values.ids.item()) }, new PlatformTrace((event) => controls.recorder.record(event)), () => controls.values.clock.now(), storage instanceof SqliteStorage ? storage[selectQuery].bind(storage) : undefined);
+        runtime = createRuntime({
+            observer: controls.observer,
+            transactions: storage.transactions,
+            modules: [
+                createPackageModule(storage),
+                platform.module(),
+                createFixtureModule(storage, () => controls.values.ids.fixture()),
+                ...(options.modules ?? []),
+            ],
+        });
+        if (setup && !("database" in setup)) {
+            importConfiguredSetup(runtime, storage, setup, useBuiltin);
+        }
+        else if (!setup && !useBuiltin) {
+            runtime.executeSync(importPackageDocuments, []);
+        }
+        const baseline = setup && "database" in setup ? setup.database : storage.snapshot();
+        markCheckpoint(storage, baseline);
+        if (setup && "database" in setup && storage instanceof SqliteStorage) {
+            storage[retainCheckpoint](baseline);
+        }
+        return new HarnessInstance(storage, runtime, platform, controls, baseline);
+    }
+    catch (error) {
+        throw combinedFailure("Engine initialization and cleanup failed.", [
+            error,
+            ...disposeResources(storage, runtime),
+        ]);
+    }
+}
+function importConfiguredSetup(runtime, storage, setup, useBuiltin) {
+    if (useBuiltin) {
+        withImportBaseline(storage, builtinDatabase(), () => runtime.executeSync(importSetupDocuments, setup));
+    }
+    else {
+        runtime.executeSync(importSetupDocuments, setup);
+    }
+}
+function markCheckpoint(storage, image) {
+    if (storage instanceof SqliteStorage) {
+        storage[setCheckpoint](image);
+    }
+}
+function resetCheckpoint(storage, image) {
+    if (storage instanceof SqliteStorage && storage[restoreCheckpoint](image)) {
+        return;
+    }
+    storage.restore(image);
+    markCheckpoint(storage, image);
+}
+class HarnessInstance {
+    storage;
+    runtime;
+    platform;
+    controls;
+    baseline;
+    closed = false;
+    packageReads = 0;
+    state;
+    clock;
+    constructor(storage, runtime, platform, controls, baseline) {
+        this.storage = storage;
+        this.runtime = runtime;
+        this.platform = platform;
+        this.controls = controls;
+        this.baseline = baseline;
+        this.state = createStateReader(storage, () => this.assertReadable());
+        this.clock = controls.values.clock.control(() => this.assertOpen(), () => this.assertIdle());
+        controls.values.checkpoint();
+    }
+    get trace() {
+        return this.platform.trace.read((requestId) => this.runtime.transactionOutcome(requestId));
+    }
+    capture() {
+        this.assertIdle();
+        if (this.storage instanceof SqliteStorage) {
+            this.storage[retainCheckpoint](this.baseline);
+        }
+        return { database: this.baseline, values: this.controls.values.capture() };
+    }
+    get executions() {
+        return this.controls.recorder.executions;
+    }
+    observe(callback) {
+        this.assertIdle();
+        return this.controls.observers.add(callback);
+    }
+    injectFailure(injection) {
+        this.assertIdle();
+        return this.controls.failures.add(injection);
+    }
+    clearExecutions() {
+        this.assertIdle();
+        this.controls.recorder.reset();
+    }
+    seed(type, properties) {
+        this.assertCallable();
+        return this.runtime.executeSync(seedOperation, { type, properties });
+    }
+    inspect(reference) {
+        this.assertIdle();
+        return this.platform.inspect(reference);
+    }
+    find(type, properties) {
+        this.assertIdle();
+        // oxlint-disable-next-line unicorn/no-array-method-this-argument -- Platform record lookup.
+        return this.platform.find(type, properties);
+    }
+    item(reference, action) {
+        this.assertIdle();
+        return this.platform.item(reference, action);
+    }
+    apply(item) {
+        return this.execute(() => this.runtime.execute(applyItemOperation, item.clone()));
+    }
+    applyAML(xml) {
+        return this.execute(() => this.runtime.execute(applyAMLOperation, xml));
+    }
+    callMethod(name, context) {
+        return this.execute(() => this.runtime.execute(callMethodOperation, {
+            name,
+            context: context.clone(),
+        }));
+    }
+    async loadPackages(paths) {
+        this.assertCallable();
+        this.packageReads += 1;
+        try {
+            const documents = await loadAmlDocuments(paths.map((path) => ({ path })));
+            return await this.runtime.execute(importPackageDocuments, documents);
+        }
+        finally {
+            this.packageReads -= 1;
+        }
+    }
+    checkpoint() {
+        this.assertIdle();
+        const baseline = this.storage.snapshot();
+        markCheckpoint(this.storage, baseline);
+        this.baseline = baseline;
+        this.controls.values.checkpoint();
+    }
+    reset() {
+        this.assertIdle();
+        try {
+            this.runtime.reset();
+            resetCheckpoint(this.storage, this.baseline);
+            this.controls.values.reset();
+        }
+        catch (error) {
+            this.closed = true;
+            this.baseline = new Uint8Array();
+            this.controls.close();
+            throw combinedFailure("Engine reset and cleanup failed.", [
+                error,
+                ...disposeResources(this.storage, this.runtime),
+            ]);
+        }
+    }
+    close() {
+        if (this.closed) {
+            return;
+        }
+        this.assertIdle();
+        this.closed = true;
+        this.baseline = new Uint8Array();
+        const failures = disposeResources(this.storage, this.runtime);
+        this.controls.close();
+        if (failures.length) {
+            throw combinedFailure("Engine cleanup failed.", failures);
+        }
+    }
+    [Symbol.dispose]() {
+        this.close();
+    }
+    async execute(operation) {
+        this.assertCallable();
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (error instanceof ApplicationError) {
+                return error.item.clone();
+            }
+            throw error;
+        }
+    }
+    assertOpen() {
+        if (this.closed) {
+            throw new RuntimeError("RuntimeClosed", "The harness is closed.");
+        }
+    }
+    assertCallable() {
+        this.assertOpen();
+        if (this.controls.observers.isNotifying) {
+            throw new RuntimeError("WorldBusy", "Execution observers cannot reenter business operations.");
+        }
+    }
+    assertReadable() {
+        this.assertOpen();
+        if (!this.controls.observers.isNotifying) {
+            this.assertIdle();
+        }
+    }
+    assertIdle() {
+        this.assertOpen();
+        if (this.runtime.isBusy || this.packageReads > 0) {
+            throw new RuntimeError("WorldBusy", "Wait for active operations and package reads before changing the test baseline.");
+        }
+    }
+}
+/** Both resources must be released even if a module's cleanup fails. */
+function disposeResources(storage, runtime) {
+    const failures = [];
+    try {
+        runtime?.close();
+    }
+    catch (error) {
+        failures.push(error);
+    }
+    try {
+        storage.close();
+    }
+    catch (error) {
+        failures.push(error);
+    }
+    return failures;
+}
+function combinedFailure(message, failures) {
+    if (failures.length === 1) {
+        return failures[0];
+    }
+    return new AggregateError(failures, message);
+}
+//# sourceMappingURL=instance.js.map

package/dist/engine/instance.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,5 @@
+import type { Engine, EngineOptions } from "./engine/instance.js";
+export type { Engine, EngineOptions } from "./engine/instance.js";
+/** Open a platform world with the built-in baseline and optional engine extensions. */
+export declare function createEngine(options?: EngineOptions): Engine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAElE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAElE,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAEhE"}

package/dist/engine.js

@@ -0,0 +1,6 @@
+import { openEngine } from "./engine/instance.js";
+/** Open a platform world with the built-in baseline and optional engine extensions. */
+export function createEngine(options = {}) {
+    return openEngine(options);
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKlD,uFAAuF;AACvF,MAAM,UAAU,YAAY,CAAC,OAAO,GAAkB,EAAE;IACpD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/fixtures/module.d.ts

@@ -0,0 +1,5 @@
+import type { HarnessModule } from "../core/types.js";
+import type { HarnessStorage } from "../storage/types.js";
+export declare const loadFixtureRecords: import("../core/operation.js").Operation<Readonly<Record<string, readonly Readonly<Record<string, import("./types.js").FixtureValue>>[]>>, void>;
+export declare function createFixtureModule(storage: HarnessStorage, nextId?: () => string): HarnessModule;
+//# sourceMappingURL=module.d.ts.map

package/dist/fixtures/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/fixtures/module.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKxE,OAAO,KAAK,EACR,cAAc,EAIjB,MAAM,qBAAqB,CAAC;AAS7B,eAAO,MAAM,kBAAkB,kJAAmD,CAAC;AAEnF,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,cAAc,EACvB,MAAM,GAAE,MAAM,MAAoE,GACnF,aAAa,CAWf"}

package/dist/fixtures/module.js

@@ -0,0 +1,112 @@
+import { spendContext } from "../core/context.js";
+import { setOwn } from "../core/data.js";
+import { defineOperation } from "../core/operation.js";
+import { seedRecordsOperation } from "../platform/engine.js";
+import { PlatformError } from "../platform/errors.js";
+import { matches } from "../platform/query.js";
+import { normalizeProperties } from "../platform/values.js";
+export const loadFixtureRecords = defineOperation("fixtures.load");
+export function createFixtureModule(storage, nextId = () => crypto.randomUUID().replaceAll("-", "").toUpperCase()) {
+    return {
+        id: "fixtures",
+        requires: ["platform"],
+        setup(registrar) {
+            registrar.handleSync(loadFixtureRecords, (fixtures, context) => {
+                load(fixtures, storage, context, nextId);
+            });
+        },
+    };
+}
+function load(fixtures, storage, context, nextId) {
+    const pending = [];
+    for (const [type, records] of Object.entries(fixtures)) {
+        const definition = storage.getItemType(type);
+        if (!definition) {
+            throw new PlatformError("MissingItemType", `Fixture ItemType '${type}' is not imported.`);
+        }
+        for (const values of records) {
+            spendContext(context);
+            pending.push({
+                id: nextId(),
+                definition,
+                values,
+            });
+        }
+    }
+    // Reserve every identity before resolving edges, so required references may form cycles.
+    const targets = new Set(pending.map((record) => JSON.stringify([record.definition.name.toLowerCase(), record.id.toLowerCase()])));
+    const candidates = pending.map((record) => ({
+        id: record.id,
+        type: record.definition.name,
+        properties: normalizeProperties(storage, record.definition, scalarValues(record), {
+            creating: false,
+            pendingReferences: targets,
+        }),
+    }));
+    const records = pending.map((record) => ({
+        id: record.id,
+        type: record.definition.name,
+        properties: resolveValues(record, candidates, storage, context),
+    }));
+    context.executeSync(seedRecordsOperation, records);
+}
+function scalarValues(record) {
+    const values = {
+        config_id: record.id,
+        generation: 1,
+        is_current: 1,
+    };
+    for (const property of record.definition.properties) {
+        if (property.defaultValue !== undefined) {
+            setOwn(values, property.name, property.defaultValue);
+        }
+    }
+    for (const [name, value] of Object.entries(record.values)) {
+        if (value === null || typeof value !== "object") {
+            setOwn(values, name, value);
+        }
+    }
+    return values;
+}
+function resolveValues(record, candidates, storage, context) {
+    const values = {};
+    for (const [name, value] of Object.entries(record.values)) {
+        if (value === null || typeof value !== "object") {
+            setOwn(values, name, value);
+            continue;
+        }
+        const property = record.definition.properties.find((property) => property.name === name);
+        const target = storage
+            .listItemTypes()
+            .find((type) => type.id.toLowerCase() === property?.dataSource?.toLowerCase());
+        if (property?.dataType !== "item" || !target) {
+            throw new PlatformError("InvalidFixtureReference", `'${record.definition.name}.${name}' has no imported ItemType target.`);
+        }
+        const predicates = Object.entries(value).map(([name, value]) => ({ name, value }));
+        if (predicates.length === 0) {
+            throw new PlatformError("InvalidFixtureReference", "Fixture references require a non-empty selector.");
+        }
+        for (const { name } of predicates) {
+            if (name !== "id" && !target.properties.some((property) => property.name === name)) {
+                throw new PlatformError("UnknownProperty", `Unknown fixture selector '${target.name}.${name}'.`);
+            }
+        }
+        const available = [
+            ...storage.listItems(target.name),
+            ...candidates.filter((candidate) => candidate.type === target.name),
+        ];
+        const matching = available.filter((candidate) => {
+            spendContext(context, predicates.length);
+            return predicates.every((predicate) => matches(storage, target, candidate, predicate));
+        });
+        const reference = matching[0];
+        if (matching.length !== 1 || !reference) {
+            const code = matching.length === 0 ? "UnresolvedFixtures" : "AmbiguousFixtureReference";
+            throw new PlatformError(code, `Fixture '${record.definition.name}.${name}' selector ${JSON.stringify(value)} ` +
+                `matched ${matching.length} '${target.name}' records; expected one.`);
+        }
+        setOwn(values, name, reference.id);
+    }
+    return values;
+}
+//# sourceMappingURL=module.js.map

package/dist/fixtures/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/fixtures/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAe5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAiB,eAAe,CAAC,CAAC;AAEnF,MAAM,UAAU,mBAAmB,CAC/B,OAAuB,EACvB,MAAM,GAAiB,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE;IAElF,OAAO;QACH,EAAE,EAAE,UAAU;QACd,QAAQ,EAAE,CAAC,UAAU,CAAC;QAEtB,KAAK,CAAC,SAAS;YACX,SAAS,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;gBAC3D,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;QACP,CAAC;KACJ,CAAC;AACN,CAAC;AAED,SAAS,IAAI,CACT,QAAkB,EAClB,OAAuB,EACvB,OAAyB,EACzB,MAAoB;IAEpB,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,aAAa,CACnB,iBAAiB,EACjB,qBAAqB,IAAI,oBAAoB,CAChD,CAAC;QACN,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,MAAM,EAAE;gBACZ,UAAU;gBACV,MAAM;aACT,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,yFAAyF;IACzF,MAAM,OAAO,GAAG,IAAI,GAAG,CACnB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACnB,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAClF,CACJ,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAc,EAAE,CAAC,CAAC;QACpD,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI;QAC5B,UAAU,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE;YAC9E,QAAQ,EAAE,KAAK;YACf,iBAAiB,EAAE,OAAO;SAC7B,CAAC;KACL,CAAC,CAAC,CAAC;IACJ,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACrC,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI;QAC5B,UAAU,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC;KAClE,CAAC,CAAC,CAAC;IACJ,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,YAAY,CAAC,MAAqB;IACvC,MAAM,MAAM,GAAiC;QACzC,SAAS,EAAE,MAAM,CAAC,EAAE;QACpB,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;KAChB,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QAClD,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAClB,MAAqB,EACrB,UAAiC,EACjC,OAAuB,EACvB,OAAyB;IAEzB,MAAM,MAAM,GAAiC,EAAE,CAAC;IAEhD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAC5B,SAAS;QACb,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,OAAO;aACjB,aAAa,EAAE;aACf,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;QAEnF,IAAI,QAAQ,EAAE,QAAQ,KAAK,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,IAAI,aAAa,CACnB,yBAAyB,EACzB,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,oCAAoC,CACzE,CAAC;QACN,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAEnF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,aAAa,CACnB,yBAAyB,EACzB,kDAAkD,CACrD,CAAC;QACN,CAAC;QAED,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC;YAChC,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACjF,MAAM,IAAI,aAAa,CACnB,iBAAiB,EACjB,6BAA6B,MAAM,CAAC,IAAI,IAAI,IAAI,IAAI,CACvD,CAAC;YACN,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG;YACd,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;YACjC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC;SACtE,CAAC;QACF,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE;YAC5C,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YAEzC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QAC3F,CAAC,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAE9B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,2BAA2B,CAAC;YAExF,MAAM,IAAI,aAAa,CACnB,IAAI,EACJ,YAAY,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,cAAc,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;gBAC5E,WAAW,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,0BAA0B,CAC3E,CAAC;QACN,CAAC;QAED,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/fixtures/types.d.ts

@@ -0,0 +1,7 @@
+import type { StorageValue } from "../storage/types.js";
+/** An object value selects an existing record of the property's target ItemType. */
+export type FixtureValue = StorageValue | Readonly<Record<string, StorageValue>>;
+export type FixtureRecord = Readonly<Record<string, FixtureValue>>;
+/** ItemType names map to starting records; schema always comes from packages. */
+export type Fixtures = Readonly<Record<string, readonly FixtureRecord[]>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/fixtures/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fixtures/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,oFAAoF;AACpF,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;AAEjF,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;AAEnE,iFAAiF;AACjF,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC,CAAC,CAAC"}

package/dist/fixtures/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/fixtures/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/fixtures/types.ts"],"names":[],"mappings":""}

package/dist/harness/configuration.d.ts

@@ -0,0 +1,53 @@
+import type { ClockSettings } from "../controls/clock.js";
+import type { IdSettings } from "../controls/ids.js";
+import type { CSharpOptions } from "../methods/csharp/compiler.js";
+import type { MockRegistry } from "../mocks/registry.js";
+import type { MockInput } from "../mocks/types.js";
+import type { PackageInputError } from "../packages/files.js";
+import type { PlatformOptions } from "../platform/engine.js";
+import type { StorageValue } from "../storage/types.js";
+import type { ExecutorFactory, ModuleFactory } from "./extensions.js";
+export interface HarnessConfig {
+    readonly clock?: ClockSettings;
+    readonly ids?: IdSettings;
+    /** Additional inputs, relative to the config file. .harness/packages is always loaded. */
+    readonly packages?: readonly string[];
+    readonly fixtures?: readonly string[];
+    readonly csharp?: CSharpOptions | false;
+    readonly authorization?: PlatformOptions["authorization"];
+    readonly session?: {
+        readonly user: Readonly<Record<string, StorageValue>>;
+    };
+    readonly modules?: readonly ModuleFactory[];
+    readonly executors?: readonly ExecutorFactory[];
+    readonly mocks?: readonly MockInput[];
+}
+export interface HarnessOptions extends HarnessConfig {
+    readonly cwd?: string;
+    readonly config?: string | HarnessConfig;
+}
+export interface ResolvedConfig {
+    readonly harnessDirectory: string;
+    readonly directory: string;
+    readonly settings: HarnessConfig;
+    readonly packages: readonly string[];
+    readonly fixtures: readonly string[];
+    readonly mocks: MockRegistry;
+}
+export interface ResolvedSettings {
+    readonly directory: string;
+    readonly harnessDirectory: string;
+    readonly configured: HarnessConfig;
+    readonly settings: HarnessConfig;
+}
+export interface PackageConfiguration extends ResolvedSettings {
+    readonly packages: readonly string[];
+}
+/** Managed paths follow the same config-directory semantics during execution and inspection. */
+export declare function resolveCSharpOptions(configuration: Pick<PackageConfiguration, "settings" | "directory">): CSharpOptions;
+export declare function loadConfiguration(options: HarnessOptions): Promise<ResolvedConfig>;
+/** Package inspection shares configuration and discovery without starting world setup. */
+export declare function loadPackageConfiguration(options: Pick<HarnessOptions, "cwd" | "config" | "packages">, onError: (error: PackageInputError) => void): Promise<readonly string[]>;
+/** Inspection reads shared settings without loading fixtures or constructing extensions. */
+export declare function loadPackageSettings(options: HarnessOptions, onError: (error: PackageInputError) => void): Promise<PackageConfiguration>;
+//# sourceMappingURL=configuration.d.ts.map

package/dist/harness/configuration.d.ts.map

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