qnce-engine 1.3.1 → 1.4.1

package/dist/quantum/entangler.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Entangler primitive for declarative variable binding
+ * @beta
+ * @experimental
+ */
+export type TransformFn = (value: unknown) => unknown;
+/** @beta @experimental */
+export declare class Entangler<TKey extends string = string> {
+    private bindings;
+    bind(from: TKey, to: TKey, transform?: TransformFn): this;
+    apply(flags: Record<string, unknown>): void;
+}
+//# sourceMappingURL=entangler.d.ts.map

package/dist/quantum/entangler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entangler.d.ts","sourceRoot":"","sources":["../../src/quantum/entangler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;AAEtD,0BAA0B;AAC1B,qBAAa,SAAS,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IACjD,OAAO,CAAC,QAAQ,CAAgE;IAEhF,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,WAAW;IAKlD,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMrC"}

package/dist/quantum/entangler.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Entangler primitive for declarative variable binding
+ * @beta
+ * @experimental
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Entangler = void 0;
+/** @beta @experimental */
+class Entangler {
+    bindings = [];
+    bind(from, to, transform) {
+        this.bindings.push({ from, to, transform });
+        return this;
+    }
+    apply(flags) {
+        for (const b of this.bindings) {
+            const v = flags[b.from];
+            flags[b.to] = b.transform ? b.transform(v) : v;
+        }
+    }
+}
+exports.Entangler = Entangler;
+//# sourceMappingURL=entangler.js.map

package/dist/quantum/entangler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entangler.js","sourceRoot":"","sources":["../../src/quantum/entangler.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAIH,0BAA0B;AAC1B,MAAa,SAAS;IACZ,QAAQ,GAA6D,EAAE,CAAC;IAEhF,IAAI,CAAC,IAAU,EAAE,EAAQ,EAAE,SAAuB;QAChD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAA8B;QAClC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC;YAClC,KAAK,CAAC,CAAC,CAAC,EAAY,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;CACF;AAdD,8BAcC"}

package/dist/quantum/flags.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Feature flags utility to gate experimental behavior
+ * @beta
+ * @experimental
+ */
+/**
+ * @beta
+ * @experimental
+ */
+export type FeatureFlagsConfig = {
+    [flag: string]: boolean;
+};
+/** @beta @experimental */
+export declare class FeatureFlags {
+    private flags;
+    constructor(initial?: FeatureFlagsConfig);
+    enable(flag: string): void;
+    disable(flag: string): void;
+    isEnabled(flag: string): boolean;
+    getAll(): {
+        [x: string]: boolean;
+    };
+}
+//# sourceMappingURL=flags.d.ts.map

package/dist/quantum/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/quantum/flags.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB,CAAC;AAEF,0BAA0B;AAC1B,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAqB;gBAEtB,OAAO,CAAC,EAAE,kBAAkB;IAIxC,MAAM,CAAC,IAAI,EAAE,MAAM;IAInB,OAAO,CAAC,IAAI,EAAE,MAAM;IAIpB,SAAS,CAAC,IAAI,EAAE,MAAM;IAItB,MAAM;;;CAGP"}

package/dist/quantum/flags.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Feature flags utility to gate experimental behavior
+ * @beta
+ * @experimental
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlags = void 0;
+/** @beta @experimental */
+class FeatureFlags {
+    flags;
+    constructor(initial) {
+        this.flags = { ...(initial || {}) };
+    }
+    enable(flag) {
+        this.flags[flag] = true;
+    }
+    disable(flag) {
+        this.flags[flag] = false;
+    }
+    isEnabled(flag) {
+        return !!this.flags[flag];
+    }
+    getAll() {
+        return { ...this.flags };
+    }
+}
+exports.FeatureFlags = FeatureFlags;
+//# sourceMappingURL=flags.js.map

package/dist/quantum/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/quantum/flags.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAUH,0BAA0B;AAC1B,MAAa,YAAY;IACf,KAAK,CAAqB;IAElC,YAAY,OAA4B;QACtC,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAtBD,oCAsBC"}

package/dist/quantum/integration.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Optional integration helpers for quantum primitives behind feature flags
+ * @beta
+ * @experimental
+ */
+import type { QNCEEngine } from '../engine/core.js';
+import { Phase } from './phase.js';
+import { Entangler } from './entangler.js';
+import { FeatureFlags, type FeatureFlagsConfig } from './flags.js';
+/** @beta @experimental */
+export type QuantumIntegration = {
+    isPhaseActive: (phase: Phase, ctx?: {
+        nodeId?: string;
+    }) => boolean;
+    entangle: (configure: (e: Entangler) => Entangler) => void;
+    detach: () => void;
+    flags: FeatureFlags;
+};
+/**
+ * Attach optional quantum helpers to an engine instance. No-ops unless the corresponding
+ * feature flags are enabled. This does not mutate engine behavior; it only provides
+ * opt-in utilities that operate against engine.flags.
+ */
+/** @beta @experimental */
+export declare function attachQuantumFeatures(engine: Pick<QNCEEngine, 'flags'>, flagsConfig?: FeatureFlags | FeatureFlagsConfig): QuantumIntegration;
+//# sourceMappingURL=integration.d.ts.map

package/dist/quantum/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../src/quantum/integration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEnE,0BAA0B;AAC1B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;IACpE,QAAQ,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,SAAS,KAAK,IAAI,CAAC;IAC3D,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,0BAA0B;AAC1B,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EACjC,WAAW,CAAC,EAAE,YAAY,GAAG,kBAAkB,GAC9C,kBAAkB,CAoBpB"}

package/dist/quantum/integration.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Optional integration helpers for quantum primitives behind feature flags
+ * @beta
+ * @experimental
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attachQuantumFeatures = attachQuantumFeatures;
+const entangler_js_1 = require("./entangler.js");
+const flags_js_1 = require("./flags.js");
+/**
+ * Attach optional quantum helpers to an engine instance. No-ops unless the corresponding
+ * feature flags are enabled. This does not mutate engine behavior; it only provides
+ * opt-in utilities that operate against engine.flags.
+ */
+/** @beta @experimental */
+function attachQuantumFeatures(engine, flagsConfig) {
+    const flags = flagsConfig instanceof flags_js_1.FeatureFlags ? flagsConfig : new flags_js_1.FeatureFlags(flagsConfig);
+    const isOn = (key) => flags.isEnabled(key);
+    return {
+        flags,
+        isPhaseActive: (phase, ctx) => {
+            if (!isOn('quantum.phases'))
+                return false;
+            return phase.isActive({ flags: engine.flags, nodeId: ctx?.nodeId });
+        },
+        entangle: (configure) => {
+            if (!isOn('quantum.entanglement'))
+                return; // no-op when disabled
+            const e = new entangler_js_1.Entangler();
+            configure(e).apply(engine.flags);
+        },
+        detach: () => {
+            // currently stateless; reserved for future wiring
+        }
+    };
+}
+//# sourceMappingURL=integration.js.map

package/dist/quantum/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","sourceRoot":"","sources":["../../src/quantum/integration.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAqBH,sDAuBC;AAxCD,iDAA2C;AAC3C,yCAAmE;AAUnE;;;;GAIG;AACH,0BAA0B;AAC1B,SAAgB,qBAAqB,CACnC,MAAiC,EACjC,WAA+C;IAE/C,MAAM,KAAK,GAAG,WAAW,YAAY,uBAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,uBAAY,CAAC,WAAW,CAAC,CAAC;IAEhG,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAEnD,OAAO;QACL,KAAK;QACL,aAAa,EAAE,CAAC,KAAY,EAAE,GAAyB,EAAE,EAAE;YACzD,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC1C,OAAO,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,QAAQ,EAAE,CAAC,SAAsC,EAAE,EAAE;YACnD,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC;gBAAE,OAAO,CAAC,sBAAsB;YACjE,MAAM,CAAC,GAAG,IAAI,wBAAS,EAAE,CAAC;YAC1B,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,EAAE,GAAG,EAAE;YACX,kDAAkD;QACpD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/quantum/measurement.d.ts

@@ -0,0 +1,22 @@
+/** @beta @experimental */
+export type MeasurementContext = {
+    flags: Record<string, unknown>;
+    nodeId?: string;
+};
+/** @beta @experimental */
+export type Sampler = (ctx: MeasurementContext) => boolean | number;
+/** @beta @experimental */
+export declare class Measurement {
+    readonly name: string;
+    private sampler?;
+    private trials;
+    private successes;
+    constructor(name: string, sampler?: Sampler);
+    sample(ctx?: MeasurementContext): boolean;
+    getStats(): {
+        trials: number;
+        successes: number;
+        rate: number;
+    };
+}
+//# sourceMappingURL=measurement.d.ts.map

package/dist/quantum/measurement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement.d.ts","sourceRoot":"","sources":["../../src/quantum/measurement.ts"],"names":[],"mappings":"AAGA,0BAA0B;AAC1B,MAAM,MAAM,kBAAkB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,0BAA0B;AAC1B,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,GAAG,MAAM,CAAC;AAEpE,0BAA0B;AAC1B,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAK;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAK3C,MAAM,CAAC,GAAG,GAAE,kBAAkC,GAAG,OAAO;IAmBxD,QAAQ;;;;;CAKT"}

package/dist/quantum/measurement.js

@@ -0,0 +1,44 @@
+"use strict";
+// Experimental Measurement primitive
+// Allows sampling outcomes (boolean or probabilistic) and tracking rates.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Measurement = void 0;
+/** @beta @experimental */
+class Measurement {
+    name;
+    sampler;
+    trials = 0;
+    successes = 0;
+    constructor(name, sampler) {
+        this.name = name;
+        this.sampler = sampler;
+    }
+    sample(ctx = { flags: {} }) {
+        let result;
+        if (this.sampler) {
+            const out = this.sampler(ctx);
+            if (typeof out === 'number') {
+                const p = Math.max(0, Math.min(1, out));
+                result = Math.random() < p;
+            }
+            else {
+                result = !!out;
+            }
+        }
+        else {
+            // default fair coin
+            result = Math.random() < 0.5;
+        }
+        this.trials++;
+        if (result)
+            this.successes++;
+        return result;
+    }
+    getStats() {
+        const { trials, successes } = this;
+        const rate = trials > 0 ? successes / trials : 0;
+        return { trials, successes, rate };
+    }
+}
+exports.Measurement = Measurement;
+//# sourceMappingURL=measurement.js.map

package/dist/quantum/measurement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement.js","sourceRoot":"","sources":["../../src/quantum/measurement.ts"],"names":[],"mappings":";AAAA,qCAAqC;AACrC,0EAA0E;;;AAQ1E,0BAA0B;AAC1B,MAAa,WAAW;IACb,IAAI,CAAS;IACd,OAAO,CAAW;IAClB,MAAM,GAAG,CAAC,CAAC;IACX,SAAS,GAAG,CAAC,CAAC;IAEtB,YAAY,IAAY,EAAE,OAAiB;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,MAA0B,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5C,IAAI,MAAe,CAAC;QACpB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACxC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,oBAAoB;YACpB,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,MAAM;YAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,QAAQ;QACN,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrC,CAAC;CACF;AAnCD,kCAmCC"}

package/dist/quantum/phase.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Phase primitive representing a labeled coexistence region
+ * @beta
+ * @experimental
+ */
+/** @beta @experimental */
+export interface PhaseContext {
+    flags: Record<string, unknown>;
+    nodeId?: string;
+}
+/** @beta @experimental */
+export type PhasePredicate = (ctx: PhaseContext) => boolean;
+/** @beta @experimental */
+export declare class Phase {
+    readonly name: string;
+    when?: PhasePredicate | undefined;
+    constructor(name: string, when?: PhasePredicate | undefined);
+    isActive(ctx: PhaseContext): boolean;
+}
+//# sourceMappingURL=phase.d.ts.map

package/dist/quantum/phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../src/quantum/phase.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0BAA0B;AAC1B,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC;AAE5D,0BAA0B;AAC1B,qBAAa,KAAK;aACY,IAAI,EAAE,MAAM;IAAS,IAAI,CAAC,EAAE,cAAc;gBAA1C,IAAI,EAAE,MAAM,EAAS,IAAI,CAAC,EAAE,cAAc,YAAA;IACtE,QAAQ,CAAC,GAAG,EAAE,YAAY;CAG3B"}

package/dist/quantum/phase.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Phase primitive representing a labeled coexistence region
+ * @beta
+ * @experimental
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Phase = void 0;
+/** @beta @experimental */
+class Phase {
+    name;
+    when;
+    constructor(name, when) {
+        this.name = name;
+        this.when = when;
+    }
+    isActive(ctx) {
+        return !this.when || this.when(ctx);
+    }
+}
+exports.Phase = Phase;
+//# sourceMappingURL=phase.js.map

package/dist/quantum/phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.js","sourceRoot":"","sources":["../../src/quantum/phase.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAWH,0BAA0B;AAC1B,MAAa,KAAK;IACY;IAAqB;IAAjD,YAA4B,IAAY,EAAS,IAAqB;QAA1C,SAAI,GAAJ,IAAI,CAAQ;QAAS,SAAI,GAAJ,IAAI,CAAiB;IAAG,CAAC;IAC1E,QAAQ,CAAC,GAAiB;QACxB,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;CACF;AALD,sBAKC"}

package/dist/quantum/types.d.ts

@@ -0,0 +1,12 @@
+/** @beta @experimental */
+export type FeatureFlagKey = string;
+/** @beta @experimental */
+export type EntangleTransform = (value: unknown) => unknown;
+/** @beta @experimental */
+export interface PhasePredicateContext {
+    flags: Record<string, unknown>;
+    nodeId?: string;
+}
+/** @beta @experimental */
+export type PhasePredicate = (ctx: PhasePredicateContext) => boolean;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/quantum/types.ts"],"names":[],"mappings":"AAGA,0BAA0B;AAC1B,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,0BAA0B;AAC1B,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;AAE5D,0BAA0B;AAC1B,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0BAA0B;AAC1B,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC"}

package/dist/quantum/types.js

@@ -0,0 +1,5 @@
+"use strict";
+// Experimental helper types for quantum primitives
+// These are opt-in and may change.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/quantum/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/quantum/types.ts"],"names":[],"mappings":";AAAA,mDAAmD;AACnD,mCAAmC"}

package/dist/schemas/validateStoryData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateStoryData.d.ts","sourceRoot":"","sources":["../../src/schemas/validateStoryData.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB,CAGnE"}
+{"version":3,"file":"validateStoryData.d.ts","sourceRoot":"","sources":["../../src/schemas/validateStoryData.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,WAAW,EAAyC,MAAM,KAAK,CAAC;AAE9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAUhD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB,CAInE"}

package/dist/schemas/validateStoryData.js

@@ -8,9 +8,15 @@ exports.validateStoryData = validateStoryData;
 const ajv_1 = __importDefault(require("ajv"));
 const story_data_schema_json_1 = __importDefault(require("./story-data.schema.json"));
 const ajv = new ajv_1.default({ allErrors: true });
-const validateFn = ajv.compile(story_data_schema_json_1.default);
+const _validateFn = ajv.compile(story_data_schema_json_1.default);
+const validateFn = ((data) => _validateFn(data));
+// Attach errors getter compatibility
+Object.defineProperty(validateFn, 'errors', {
+    get: () => _validateFn.errors,
+});
 function validateStoryData(data) {
     const valid = validateFn(data);
-    return { valid, errors: valid ? undefined : (validateFn.errors || undefined) };
+    const errs = validateFn.errors;
+    return { valid, errors: valid ? undefined : (errs || undefined) };
 }
 //# sourceMappingURL=validateStoryData.js.map

package/dist/schemas/validateStoryData.js.map

@@ -1 +1 @@
-{"version":3,"file":"validateStoryData.js","sourceRoot":"","sources":["../../src/schemas/validateStoryData.ts"],"names":[],"mappings":";;;;;AAaA,8CAGC;AAhBD,sDAAsD;AACtD,8CAAuC;AACvC,sFAA8C;AAG9C,MAAM,GAAG,GAAG,IAAI,aAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAS,CAAC,CAAC;AAChD,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,gCAAa,CAAC,CAAC;AAO9C,SAAgB,iBAAiB,CAAC,IAAe;IAC/C,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAY,CAAC;IAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE,CAAC;AACjF,CAAC"}
+{"version":3,"file":"validateStoryData.js","sourceRoot":"","sources":["../../src/schemas/validateStoryData.ts"],"names":[],"mappings":";;;;;AAkBA,8CAIC;AAtBD,sDAAsD;AACtD,8CAA8E;AAC9E,sFAA8C;AAG9C,MAAM,GAAG,GAAG,IAAI,aAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACzC,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,gCAA8B,CAAgC,CAAC;AAC/F,MAAM,UAAU,GAAG,CAAC,CAAC,IAAe,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAY,CAA8D,CAAC;AACpI,qCAAqC;AACrC,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE;IAC1C,GAAG,EAAE,GAAG,EAAE,CAAE,WAAW,CAAC,MAA+C;CACxE,CAAC,CAAC;AAOH,SAAgB,iBAAiB,CAAC,IAAe;IAC/C,MAAM,KAAK,GAAY,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,IAAI,GAAI,UAAoD,CAAC,MAAM,CAAC;IAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,SAAS,CAAC,EAAE,CAAC;AACpE,CAAC"}

package/dist/telemetry/core.d.ts

@@ -0,0 +1,88 @@
+import { QEvent, Telemetry, TelemetryAdapter, TelemetryOptions } from './types.js';
+/** Simple fixed-size ring buffer used by telemetry queue */
+/** @beta @experimental */
+export declare class RingBuffer<T> {
+    private capacity;
+    private buf;
+    private head;
+    private tail;
+    private _size;
+    constructor(capacity: number);
+    get size(): number;
+    get isFull(): boolean;
+    get isEmpty(): boolean;
+    push(item: T): boolean;
+    pop(): T | undefined;
+    drain(max: number): T[];
+}
+/** Internal telemetry implementation */
+/** @beta @experimental */
+export declare class TelemetryImpl implements Telemetry {
+    private opts;
+    private adapter;
+    private queue;
+    private dropped;
+    private sent;
+    private lastFlushTs;
+    private timer;
+    private prng;
+    private seq;
+    private latencies;
+    constructor(options: TelemetryOptions);
+    configure(opts: Partial<TelemetryOptions>): void;
+    emit<T extends string, P>(event: QEvent<T, P>): void;
+    flush(): Promise<void>;
+    private percentile;
+    stats(): {
+        queued: number;
+        dropped: number;
+        sent: number;
+        lastFlushTs: number | null;
+        p50: number | undefined;
+        p95: number | undefined;
+    };
+    private startTimer;
+    private restartTimer;
+    dispose(): Promise<void>;
+}
+/**
+ * Built-in console adapter (dev-friendly pretty print)
+ * @beta
+ * @experimental
+ */
+export declare class ConsoleAdapter implements TelemetryAdapter {
+    configure(): void;
+    send(batch: QEvent[]): Promise<void>;
+}
+export interface FileAdapterOptions {
+    path: string;
+    rotateBytes?: number;
+}
+/**
+ * File adapter writing newline-delimited JSON events
+ * @beta
+ * @experimental
+ */
+export declare class FileAdapter implements TelemetryAdapter {
+    private opts;
+    private stream;
+    constructor(opts: FileAdapterOptions);
+    send(batch: QEvent[]): Promise<void>;
+    flush(): Promise<void>;
+    dispose(): Promise<void>;
+}
+/**
+ * Factory for built-in telemetry adapters
+ * @beta
+ * @experimental
+ */
+export declare function createTelemetryAdapter(kind: 'console' | 'file', opts?: {
+    path?: string;
+}): TelemetryAdapter;
+/**
+ * Create a telemetry instance; pass adapter + options
+ * @beta
+ * @experimental
+ */
+export declare function createTelemetry(options: TelemetryOptions): Telemetry;
+//# sourceMappingURL=core.d.ts.map

package/dist/telemetry/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/telemetry/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAanF,4DAA4D;AAC5D,0BAA0B;AAC1B,qBAAa,UAAU,CAAC,CAAC;IAKX,OAAO,CAAC,QAAQ;IAJ5B,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAK;gBACE,QAAQ,EAAE,MAAM;IAIpC,IAAI,IAAI,IAAI,MAAM,CAAuB;IACzC,IAAI,MAAM,IAAI,OAAO,CAAyC;IAC9D,IAAI,OAAO,IAAI,OAAO,CAA6B;IACnD,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IAOtB,GAAG,IAAI,CAAC,GAAG,SAAS;IAQpB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE;CAQxB;AAED,wCAAwC;AACxC,0BAA0B;AAC1B,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,IAAI,CAA6O;IACzP,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,SAAS,CAAgB;gBAErB,OAAO,EAAE,gBAAgB;IAuBrC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAkBhD,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAyC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B,OAAO,CAAC,UAAU;IAOlB,KAAK;;;;;;;;IAWL,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,YAAY;IAMd,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B;AAGD;;;;GAIG;AACH,qBAAa,cAAe,YAAW,gBAAgB;IACrD,SAAS,IAAI,IAAI;IACX,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAO3C;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AACD;;;;GAIG;AACH,qBAAa,WAAY,YAAW,gBAAgB;IAEtC,OAAO,CAAC,IAAI;IADxB,OAAO,CAAC,MAAM,CAAc;gBACR,IAAI,EAAE,kBAAkB;IAGtC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CAM3G;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAEpE"}