@fabricorg/databricks-bdd 0.3.1 → 0.4.0

package/dist/index.d.cts

@@ -1,60 +1,13 @@
-import { World, IWorldOptions } from '@cucumber/cucumber';
-import { TestProfile, ExecutionContext, TableFixture, WorkspaceClientLike, PollOptions } from '@fabricorg/databricks-testkit';
+export { D as DatabricksWorld, a as DatabricksWorldParameters, S as ScenarioAction, d as defineAction, r as runAction } from './actions-CxfxhBZh.cjs';
+import { TestProfile, TableFixture, WorkspaceClientLike, PollOptions } from '@fabricorg/databricks-testkit';
 export { waitForPipelineUpdate } from '@fabricorg/databricks-testkit';
-import { StepOutputCapture } from './output-capture.cjs';
-export { CapturedStepOutput, StepOutputCaptureOptions, startStepOutputCapture } from './output-capture.cjs';
 export { RUN_STATES, RunState, parseDuration, parseTableIdentifier } from './parameter-types.cjs';
 export { EvidenceReport, EvidenceScenario, FAILURE_EVIDENCE_MEDIA_TYPE, StepFailureEvidence, parseFailureEvidenceAttachment, redactSecrets } from './evidence-formatter.cjs';
-
-interface DatabricksWorldParameters {
-    /** Default schema for the execution context; overridable per scenario via the catalog/schema step. */
-    schema?: string;
-    /** Arbitrary typed runner configuration, comparable to behave `-D` userdata. */
-    userdata?: Record<string, string | number | boolean>;
-}
-type Cleanup = () => void | Promise<void>;
-/**
- * Cucumber World holding one ExecutionContext per scenario. The context is
- * created lazily on first use so `Given catalog ... and schema ...` can run
- * first; it is closed by the After hook registered in ./steps.ts.
- */
-declare class DatabricksWorld extends World<DatabricksWorldParameters> {
-    readonly profile: TestProfile;
-    /** Rows from the last `When I run the SQL` / `When I query table` step. */
-    lastRows: Record<string, unknown>[] | null;
-    /** Error captured from the last statement, for `Then the statement fails ...`. */
-    lastError: Error | null;
-    /** Terminal run record from the last `When I run job ...` step. */
-    lastRun: Record<string, unknown> | null;
-    /** Pipeline update handle from `When I start a full refresh of pipeline ...`. */
-    lastPipelineUpdate: {
-        pipelineId: string;
-        updateId: string;
-    } | null;
-    schemaOverride: string | undefined;
-    catalogOverride: string | undefined;
-    lastSql: string | undefined;
-    lastStatementId: string | undefined;
-    stepOutputCapture: StepOutputCapture | undefined;
-    lakebasePool: {
-        query<T extends Record<string, unknown>>(sql: string): Promise<{
-            rows: T[];
-        }>;
-    } | undefined;
-    private ctx;
-    private activeCtx;
-    private readonly cleanups;
-    constructor(options: IWorldOptions<DatabricksWorldParameters>);
-    context(): Promise<ExecutionContext>;
-    /** Route subsequent steps through a scenario-owned secondary identity. */
-    useExecutionContext(context: ExecutionContext): void;
-    /** Register scenario-scoped cleanup. Cleanups run in reverse order. */
-    addCleanup(cleanup: Cleanup): void;
-    /** Resolve runner userdata from worldParameters first, then DBX_TEST_USERDATA_* env. */
-    userdata(name: string): string | number | boolean | undefined;
-    scopeTo(catalog: string, schema: string): void;
-    dispose(): Promise<void>;
-}
+export { CapturedStepOutput, StepOutputCapture, StepOutputCaptureOptions, startStepOutputCapture } from './output-capture.cjs';
+export { FixtureCleanup, FixtureSetup, SharedFixtureRegistry, sharedFixtures } from './fixtures.cjs';
+export { CardinalityOptions, CardinalityResult, FieldCardinality, parseCardinalityField } from './cardinality.cjs';
+export { ScopedState, SharedStateRegistry, StateScope, sharedState } from './scoped-state.cjs';
+import '@cucumber/cucumber';
 
 /**
  * Tags that require a live workspace (or a long budget). Scenarios carrying
@@ -63,6 +16,22 @@ declare class DatabricksWorld extends World<DatabricksWorldParameters> {
 declare const LIVE_ONLY_TAGS: readonly ["@live", "@jobs", "@dlt", "@pipeline", "@autoloader", "@lakebase", "@slow"];
 /** Returns a skip reason when the scenario cannot run under the given profile, else null. */
 declare function liveOnlyReason(tags: readonly string[], profile: TestProfile): string | null;
+type CapabilityValue = string | number | boolean;
+type CapabilityMap = Readonly<Record<string, CapabilityValue>>;
+/** Build the runtime capability map used by active-tag predicates. */
+declare function capabilitiesFromEnv(profile: TestProfile, env?: NodeJS.ProcessEnv): CapabilityMap;
+/**
+ * Evaluate TypeScript-native active tags.
+ *
+ * Supported forms:
+ * - `@requires.cloud=azure` / `@requires.serverless`
+ * - `@excludes.compute=classic`
+ * - Behave-compatible aliases `@use.with_cloud=azure` and
+ *   `@not.with_cloud=azure`
+ */
+declare function capabilityTagReason(tags: readonly string[], capabilities: CapabilityMap): string | null;
+/** Combined local/live and active-capability skip policy. */
+declare function scenarioSkipReason(tags: readonly string[], profile: TestProfile, env?: NodeJS.ProcessEnv): string | null;
 
 /**
  * Turn a Gherkin data table (header row + string cells) into a TableFixture,
@@ -119,4 +88,4 @@ interface RunFeaturesResult {
  */
 declare function runFeatures(options: RunFeaturesOptions): Promise<RunFeaturesResult>;
 
-export { DatabricksWorld, type DatabricksWorldParameters, type JobRunResult, LIVE_ONLY_TAGS, type PipelineWaitOptions, type RunFeaturesOptions, type RunFeaturesResult, type RunJobOptions, StepOutputCapture, coerceMatchRows, inferFixture, liveOnlyReason, resolveJobId, resolvePipelineId, runFeatures, runJobToTerminal, startPipelineUpdate };
+export { type CapabilityMap, type CapabilityValue, type JobRunResult, LIVE_ONLY_TAGS, type PipelineWaitOptions, type RunFeaturesOptions, type RunFeaturesResult, type RunJobOptions, capabilitiesFromEnv, capabilityTagReason, coerceMatchRows, inferFixture, liveOnlyReason, resolveJobId, resolvePipelineId, runFeatures, runJobToTerminal, scenarioSkipReason, startPipelineUpdate };

package/dist/index.d.ts

@@ -1,60 +1,13 @@
-import { World, IWorldOptions } from '@cucumber/cucumber';
-import { TestProfile, ExecutionContext, TableFixture, WorkspaceClientLike, PollOptions } from '@fabricorg/databricks-testkit';
+export { D as DatabricksWorld, a as DatabricksWorldParameters, S as ScenarioAction, d as defineAction, r as runAction } from './actions-CuXXKUqe.js';
+import { TestProfile, TableFixture, WorkspaceClientLike, PollOptions } from '@fabricorg/databricks-testkit';
 export { waitForPipelineUpdate } from '@fabricorg/databricks-testkit';
-import { StepOutputCapture } from './output-capture.js';
-export { CapturedStepOutput, StepOutputCaptureOptions, startStepOutputCapture } from './output-capture.js';
 export { RUN_STATES, RunState, parseDuration, parseTableIdentifier } from './parameter-types.js';
 export { EvidenceReport, EvidenceScenario, FAILURE_EVIDENCE_MEDIA_TYPE, StepFailureEvidence, parseFailureEvidenceAttachment, redactSecrets } from './evidence-formatter.js';
-
-interface DatabricksWorldParameters {
-    /** Default schema for the execution context; overridable per scenario via the catalog/schema step. */
-    schema?: string;
-    /** Arbitrary typed runner configuration, comparable to behave `-D` userdata. */
-    userdata?: Record<string, string | number | boolean>;
-}
-type Cleanup = () => void | Promise<void>;
-/**
- * Cucumber World holding one ExecutionContext per scenario. The context is
- * created lazily on first use so `Given catalog ... and schema ...` can run
- * first; it is closed by the After hook registered in ./steps.ts.
- */
-declare class DatabricksWorld extends World<DatabricksWorldParameters> {
-    readonly profile: TestProfile;
-    /** Rows from the last `When I run the SQL` / `When I query table` step. */
-    lastRows: Record<string, unknown>[] | null;
-    /** Error captured from the last statement, for `Then the statement fails ...`. */
-    lastError: Error | null;
-    /** Terminal run record from the last `When I run job ...` step. */
-    lastRun: Record<string, unknown> | null;
-    /** Pipeline update handle from `When I start a full refresh of pipeline ...`. */
-    lastPipelineUpdate: {
-        pipelineId: string;
-        updateId: string;
-    } | null;
-    schemaOverride: string | undefined;
-    catalogOverride: string | undefined;
-    lastSql: string | undefined;
-    lastStatementId: string | undefined;
-    stepOutputCapture: StepOutputCapture | undefined;
-    lakebasePool: {
-        query<T extends Record<string, unknown>>(sql: string): Promise<{
-            rows: T[];
-        }>;
-    } | undefined;
-    private ctx;
-    private activeCtx;
-    private readonly cleanups;
-    constructor(options: IWorldOptions<DatabricksWorldParameters>);
-    context(): Promise<ExecutionContext>;
-    /** Route subsequent steps through a scenario-owned secondary identity. */
-    useExecutionContext(context: ExecutionContext): void;
-    /** Register scenario-scoped cleanup. Cleanups run in reverse order. */
-    addCleanup(cleanup: Cleanup): void;
-    /** Resolve runner userdata from worldParameters first, then DBX_TEST_USERDATA_* env. */
-    userdata(name: string): string | number | boolean | undefined;
-    scopeTo(catalog: string, schema: string): void;
-    dispose(): Promise<void>;
-}
+export { CapturedStepOutput, StepOutputCapture, StepOutputCaptureOptions, startStepOutputCapture } from './output-capture.js';
+export { FixtureCleanup, FixtureSetup, SharedFixtureRegistry, sharedFixtures } from './fixtures.js';
+export { CardinalityOptions, CardinalityResult, FieldCardinality, parseCardinalityField } from './cardinality.js';
+export { ScopedState, SharedStateRegistry, StateScope, sharedState } from './scoped-state.js';
+import '@cucumber/cucumber';
 
 /**
  * Tags that require a live workspace (or a long budget). Scenarios carrying
@@ -63,6 +16,22 @@ declare class DatabricksWorld extends World<DatabricksWorldParameters> {
 declare const LIVE_ONLY_TAGS: readonly ["@live", "@jobs", "@dlt", "@pipeline", "@autoloader", "@lakebase", "@slow"];
 /** Returns a skip reason when the scenario cannot run under the given profile, else null. */
 declare function liveOnlyReason(tags: readonly string[], profile: TestProfile): string | null;
+type CapabilityValue = string | number | boolean;
+type CapabilityMap = Readonly<Record<string, CapabilityValue>>;
+/** Build the runtime capability map used by active-tag predicates. */
+declare function capabilitiesFromEnv(profile: TestProfile, env?: NodeJS.ProcessEnv): CapabilityMap;
+/**
+ * Evaluate TypeScript-native active tags.
+ *
+ * Supported forms:
+ * - `@requires.cloud=azure` / `@requires.serverless`
+ * - `@excludes.compute=classic`
+ * - Behave-compatible aliases `@use.with_cloud=azure` and
+ *   `@not.with_cloud=azure`
+ */
+declare function capabilityTagReason(tags: readonly string[], capabilities: CapabilityMap): string | null;
+/** Combined local/live and active-capability skip policy. */
+declare function scenarioSkipReason(tags: readonly string[], profile: TestProfile, env?: NodeJS.ProcessEnv): string | null;
 
 /**
  * Turn a Gherkin data table (header row + string cells) into a TableFixture,
@@ -119,4 +88,4 @@ interface RunFeaturesResult {
  */
 declare function runFeatures(options: RunFeaturesOptions): Promise<RunFeaturesResult>;
 
-export { DatabricksWorld, type DatabricksWorldParameters, type JobRunResult, LIVE_ONLY_TAGS, type PipelineWaitOptions, type RunFeaturesOptions, type RunFeaturesResult, type RunJobOptions, StepOutputCapture, coerceMatchRows, inferFixture, liveOnlyReason, resolveJobId, resolvePipelineId, runFeatures, runJobToTerminal, startPipelineUpdate };
+export { type CapabilityMap, type CapabilityValue, type JobRunResult, LIVE_ONLY_TAGS, type PipelineWaitOptions, type RunFeaturesOptions, type RunFeaturesResult, type RunJobOptions, capabilitiesFromEnv, capabilityTagReason, coerceMatchRows, inferFixture, liveOnlyReason, resolveJobId, resolvePipelineId, runFeatures, runJobToTerminal, scenarioSkipReason, startPipelineUpdate };

package/dist/index.js

@@ -1,7 +1,11 @@
-export { DatabricksWorld, LIVE_ONLY_TAGS, coerceMatchRows, inferFixture, liveOnlyReason, resolveJobId, resolvePipelineId, runJobToTerminal, startPipelineUpdate, waitForPipelineUpdate } from './chunk-FNTI2VUP.js';
+export { DatabricksWorld, LIVE_ONLY_TAGS, capabilitiesFromEnv, capabilityTagReason, coerceMatchRows, inferFixture, liveOnlyReason, resolveJobId, resolvePipelineId, runJobToTerminal, scenarioSkipReason, startPipelineUpdate, waitForPipelineUpdate } from './chunk-3XDMBHFP.js';
+export { defineAction, runAction } from './chunk-6JC65RH2.js';
+export { parseCardinalityField } from './chunk-K5LJ7WSW.js';
 export { FAILURE_EVIDENCE_MEDIA_TYPE, parseFailureEvidenceAttachment, redactSecrets } from './chunk-UQAKGVJS.js';
+export { SharedFixtureRegistry, sharedFixtures } from './chunk-SZL3KWW7.js';
 export { startStepOutputCapture } from './chunk-THB7O2G6.js';
 export { RUN_STATES, parseDuration, parseTableIdentifier } from './chunk-YNOLRERF.js';
+export { ScopedState, SharedStateRegistry, sharedState } from './chunk-HTKRJLVX.js';
 import { execFile } from 'child_process';
 import { createRequire } from 'module';
 import { join, dirname } from 'path';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/run-features.ts"],"names":["require"],"mappings":";;;;;;;;AA2BA,eAAsB,YAAY,OAAA,EAAyD;AACzF,EAAA,MAAMA,QAAAA,GAAU,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAA;AAG7C,EAAA,MAAM,OAAA,GAAUA,QAAAA,CAAQ,OAAA,CAAQ,iCAAiC,CAAA;AACjE,EAAA,MAAM,GAAA,GAAMA,SAAQ,OAAO,CAAA;AAC3B,EAAA,MAAM,GAAA,GAAM,KAAK,OAAA,CAAQ,OAAO,GAAG,GAAA,CAAI,GAAA,CAAI,aAAa,CAAA,IAAK,iBAAiB,CAAA;AAC9E,EAAA,MAAM,MAAyB,EAAE,GAAG,QAAQ,GAAA,EAAK,GAAG,QAAQ,GAAA,EAAI;AAChE,EAAA,IAAI,OAAA,CAAQ,OAAO,IAAA,EAAM;AACvB,IAAA,MAAM,SAAA,GAAY,cAAA;AAClB,IAAA,GAAA,CAAI,YAAA,GAAe,IAAI,YAAA,GAAe,CAAA,EAAG,IAAI,YAAY,CAAA,CAAA,EAAI,SAAS,CAAA,CAAA,GAAK,SAAA;AAAA,EAC7E;AACA,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY;AAC9B,IAAA,QAAA;AAAA,MACE,OAAA,CAAQ,QAAA;AAAA,MACR,CAAC,GAAA,EAAK,GAAI,OAAA,CAAQ,IAAA,IAAQ,EAAG,CAAA;AAAA,MAC7B,EAAE,GAAA,EAAK,OAAA,CAAQ,GAAA,EAAK,GAAA,EAAK,OAAA,EAAS,OAAA,CAAQ,SAAA,IAAa,IAAA,EAAS,SAAA,EAAW,EAAA,GAAK,IAAA,GAAO,IAAA,EAAK;AAAA,MAC5F,CAAC,KAAA,EAAO,MAAA,EAAQ,MAAA,KAAW;AACzB,QAAA,MAAM,QAAA,GACJ,KAAA,IAAS,OAAQ,KAAA,CAA6B,IAAA,KAAS,WACjD,KAAA,CAA4B,IAAA,IAAQ,CAAA,GACtC,KAAA,GACE,CAAA,GACA,CAAA;AACR,QAAA,OAAA,CAAQ,EAAE,OAAA,EAAS,QAAA,KAAa,GAAG,QAAA,EAAU,MAAA,EAAQ,GAAG,MAAM;AAAA,EAAK,MAAM,IAAI,CAAA;AAAA,MAC/E;AAAA,KACF;AAAA,EACF,CAAC,CAAA;AACH","file":"index.js","sourcesContent":["import { execFile } from 'node:child_process';\nimport { createRequire } from 'node:module';\nimport { dirname, join } from 'node:path';\n\nexport interface RunFeaturesOptions {\n  /** Directory containing the cucumber config / features. */\n  cwd: string;\n  /** Extra CLI args, e.g. ['--tags', 'not @slow'] or ['features/foo.feature']. */\n  args?: string[];\n  /** Extra environment (merged over process.env). */\n  env?: Record<string, string>;\n  /** Load TypeScript support code via tsx (default true). */\n  tsx?: boolean;\n  timeoutMs?: number;\n}\n\nexport interface RunFeaturesResult {\n  success: boolean;\n  exitCode: number;\n  output: string;\n}\n\n/**\n * Vitest bridge: run cucumber-js as a subprocess so feature suites can be\n * embedded in an existing vitest run (one CI entry point) without fighting\n * over cucumber's global step registry or vitest's module transforms.\n */\nexport async function runFeatures(options: RunFeaturesOptions): Promise<RunFeaturesResult> {\n  const require = createRequire(import.meta.url);\n  // The bin path is not in the package's exports map — resolve it relative\n  // to package.json (which is exported).\n  const pkgPath = require.resolve('@cucumber/cucumber/package.json');\n  const pkg = require(pkgPath) as { bin: Record<string, string> };\n  const bin = join(dirname(pkgPath), pkg.bin['cucumber-js'] ?? 'bin/cucumber.js');\n  const env: NodeJS.ProcessEnv = { ...process.env, ...options.env };\n  if (options.tsx ?? true) {\n    const tsxImport = '--import tsx';\n    env.NODE_OPTIONS = env.NODE_OPTIONS ? `${env.NODE_OPTIONS} ${tsxImport}` : tsxImport;\n  }\n  return new Promise((resolve) => {\n    execFile(\n      process.execPath,\n      [bin, ...(options.args ?? [])],\n      { cwd: options.cwd, env, timeout: options.timeoutMs ?? 120_000, maxBuffer: 16 * 1024 * 1024 },\n      (error, stdout, stderr) => {\n        const exitCode =\n          error && typeof (error as { code?: unknown }).code === 'number'\n            ? ((error as { code?: number }).code ?? 1)\n            : error\n              ? 1\n              : 0;\n        resolve({ success: exitCode === 0, exitCode, output: `${stdout}\\n${stderr}` });\n      },\n    );\n  });\n}\n"]}
+{"version":3,"sources":["../src/run-features.ts"],"names":["require"],"mappings":";;;;;;;;;;;;AA2BA,eAAsB,YAAY,OAAA,EAAyD;AACzF,EAAA,MAAMA,QAAAA,GAAU,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAA;AAG7C,EAAA,MAAM,OAAA,GAAUA,QAAAA,CAAQ,OAAA,CAAQ,iCAAiC,CAAA;AACjE,EAAA,MAAM,GAAA,GAAMA,SAAQ,OAAO,CAAA;AAC3B,EAAA,MAAM,GAAA,GAAM,KAAK,OAAA,CAAQ,OAAO,GAAG,GAAA,CAAI,GAAA,CAAI,aAAa,CAAA,IAAK,iBAAiB,CAAA;AAC9E,EAAA,MAAM,MAAyB,EAAE,GAAG,QAAQ,GAAA,EAAK,GAAG,QAAQ,GAAA,EAAI;AAChE,EAAA,IAAI,OAAA,CAAQ,OAAO,IAAA,EAAM;AACvB,IAAA,MAAM,SAAA,GAAY,cAAA;AAClB,IAAA,GAAA,CAAI,YAAA,GAAe,IAAI,YAAA,GAAe,CAAA,EAAG,IAAI,YAAY,CAAA,CAAA,EAAI,SAAS,CAAA,CAAA,GAAK,SAAA;AAAA,EAC7E;AACA,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY;AAC9B,IAAA,QAAA;AAAA,MACE,OAAA,CAAQ,QAAA;AAAA,MACR,CAAC,GAAA,EAAK,GAAI,OAAA,CAAQ,IAAA,IAAQ,EAAG,CAAA;AAAA,MAC7B,EAAE,GAAA,EAAK,OAAA,CAAQ,GAAA,EAAK,GAAA,EAAK,OAAA,EAAS,OAAA,CAAQ,SAAA,IAAa,IAAA,EAAS,SAAA,EAAW,EAAA,GAAK,IAAA,GAAO,IAAA,EAAK;AAAA,MAC5F,CAAC,KAAA,EAAO,MAAA,EAAQ,MAAA,KAAW;AACzB,QAAA,MAAM,QAAA,GACJ,KAAA,IAAS,OAAQ,KAAA,CAA6B,IAAA,KAAS,WACjD,KAAA,CAA4B,IAAA,IAAQ,CAAA,GACtC,KAAA,GACE,CAAA,GACA,CAAA;AACR,QAAA,OAAA,CAAQ,EAAE,OAAA,EAAS,QAAA,KAAa,GAAG,QAAA,EAAU,MAAA,EAAQ,GAAG,MAAM;AAAA,EAAK,MAAM,IAAI,CAAA;AAAA,MAC/E;AAAA,KACF;AAAA,EACF,CAAC,CAAA;AACH","file":"index.js","sourcesContent":["import { execFile } from 'node:child_process';\nimport { createRequire } from 'node:module';\nimport { dirname, join } from 'node:path';\n\nexport interface RunFeaturesOptions {\n  /** Directory containing the cucumber config / features. */\n  cwd: string;\n  /** Extra CLI args, e.g. ['--tags', 'not @slow'] or ['features/foo.feature']. */\n  args?: string[];\n  /** Extra environment (merged over process.env). */\n  env?: Record<string, string>;\n  /** Load TypeScript support code via tsx (default true). */\n  tsx?: boolean;\n  timeoutMs?: number;\n}\n\nexport interface RunFeaturesResult {\n  success: boolean;\n  exitCode: number;\n  output: string;\n}\n\n/**\n * Vitest bridge: run cucumber-js as a subprocess so feature suites can be\n * embedded in an existing vitest run (one CI entry point) without fighting\n * over cucumber's global step registry or vitest's module transforms.\n */\nexport async function runFeatures(options: RunFeaturesOptions): Promise<RunFeaturesResult> {\n  const require = createRequire(import.meta.url);\n  // The bin path is not in the package's exports map — resolve it relative\n  // to package.json (which is exported).\n  const pkgPath = require.resolve('@cucumber/cucumber/package.json');\n  const pkg = require(pkgPath) as { bin: Record<string, string> };\n  const bin = join(dirname(pkgPath), pkg.bin['cucumber-js'] ?? 'bin/cucumber.js');\n  const env: NodeJS.ProcessEnv = { ...process.env, ...options.env };\n  if (options.tsx ?? true) {\n    const tsxImport = '--import tsx';\n    env.NODE_OPTIONS = env.NODE_OPTIONS ? `${env.NODE_OPTIONS} ${tsxImport}` : tsxImport;\n  }\n  return new Promise((resolve) => {\n    execFile(\n      process.execPath,\n      [bin, ...(options.args ?? [])],\n      { cwd: options.cwd, env, timeout: options.timeoutMs ?? 120_000, maxBuffer: 16 * 1024 * 1024 },\n      (error, stdout, stderr) => {\n        const exitCode =\n          error && typeof (error as { code?: unknown }).code === 'number'\n            ? ((error as { code?: number }).code ?? 1)\n            : error\n              ? 1\n              : 0;\n        resolve({ success: exitCode === 0, exitCode, output: `${stdout}\\n${stderr}` });\n      },\n    );\n  });\n}\n"]}

package/dist/scoped-state.cjs

@@ -0,0 +1,74 @@
+'use strict';
+
+// src/scoped-state.ts
+var SharedStateRegistry = class {
+  runValues = /* @__PURE__ */ new Map();
+  featureValues = /* @__PURE__ */ new Map();
+  run() {
+    return this.runValues;
+  }
+  feature(featureUri) {
+    if (!featureUri) throw new Error("Feature state requires a feature URI");
+    let values = this.featureValues.get(featureUri);
+    if (!values) {
+      values = /* @__PURE__ */ new Map();
+      this.featureValues.set(featureUri, values);
+    }
+    return values;
+  }
+  clear() {
+    this.runValues.clear();
+    this.featureValues.clear();
+  }
+};
+var ScopedState = class {
+  constructor(runValues, featureValues) {
+    this.runValues = runValues;
+    this.featureValues = featureValues;
+  }
+  runValues;
+  featureValues;
+  scenarioValues = /* @__PURE__ */ new Map();
+  set(scope, key, value) {
+    this.values(scope).set(validateKey(key), value);
+    return value;
+  }
+  get(key) {
+    const validKey = validateKey(key);
+    if (this.scenarioValues.has(validKey)) return this.scenarioValues.get(validKey);
+    if (this.featureValues.has(validKey)) return this.featureValues.get(validKey);
+    return this.runValues.get(validKey);
+  }
+  require(key) {
+    const value = this.get(key);
+    if (value === void 0) throw new Error(`Required BDD state '${key}' is not set`);
+    return value;
+  }
+  has(key) {
+    const validKey = validateKey(key);
+    return this.scenarioValues.has(validKey) || this.featureValues.has(validKey) || this.runValues.has(validKey);
+  }
+  delete(scope, key) {
+    return this.values(scope).delete(validateKey(key));
+  }
+  clearScenario() {
+    this.scenarioValues.clear();
+  }
+  values(scope) {
+    if (scope === "run") return this.runValues;
+    if (scope === "feature") return this.featureValues;
+    return this.scenarioValues;
+  }
+};
+function validateKey(key) {
+  const trimmed = key.trim();
+  if (!trimmed) throw new Error("BDD state key must not be empty");
+  return trimmed;
+}
+var sharedState = new SharedStateRegistry();
+
+exports.ScopedState = ScopedState;
+exports.SharedStateRegistry = SharedStateRegistry;
+exports.sharedState = sharedState;
+//# sourceMappingURL=scoped-state.cjs.map
+//# sourceMappingURL=scoped-state.cjs.map

package/dist/scoped-state.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scoped-state.ts"],"names":[],"mappings":"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","file":"scoped-state.cjs","sourcesContent":["export type StateScope = 'run' | 'feature' | 'scenario';\n\ntype StateValues = Map<string, unknown>;\n\n/**\n * Process-local state backing Behave-style run and feature context layers.\n * Scenario values stay on the scenario World and are never shared.\n */\nexport class SharedStateRegistry {\n  private readonly runValues: StateValues = new Map();\n  private readonly featureValues = new Map<string, StateValues>();\n\n  run(): StateValues {\n    return this.runValues;\n  }\n\n  feature(featureUri: string): StateValues {\n    if (!featureUri) throw new Error('Feature state requires a feature URI');\n    let values = this.featureValues.get(featureUri);\n    if (!values) {\n      values = new Map();\n      this.featureValues.set(featureUri, values);\n    }\n    return values;\n  }\n\n  clear(): void {\n    this.runValues.clear();\n    this.featureValues.clear();\n  }\n}\n\n/** Layered state lookup: scenario overrides feature, which overrides run. */\nexport class ScopedState {\n  private readonly scenarioValues: StateValues = new Map();\n\n  constructor(\n    private readonly runValues: StateValues,\n    private readonly featureValues: StateValues,\n  ) {}\n\n  set<T>(scope: StateScope, key: string, value: T): T {\n    this.values(scope).set(validateKey(key), value);\n    return value;\n  }\n\n  get<T>(key: string): T | undefined {\n    const validKey = validateKey(key);\n    if (this.scenarioValues.has(validKey)) return this.scenarioValues.get(validKey) as T;\n    if (this.featureValues.has(validKey)) return this.featureValues.get(validKey) as T;\n    return this.runValues.get(validKey) as T | undefined;\n  }\n\n  require<T>(key: string): T {\n    const value = this.get<T>(key);\n    if (value === undefined) throw new Error(`Required BDD state '${key}' is not set`);\n    return value;\n  }\n\n  has(key: string): boolean {\n    const validKey = validateKey(key);\n    return (\n      this.scenarioValues.has(validKey) ||\n      this.featureValues.has(validKey) ||\n      this.runValues.has(validKey)\n    );\n  }\n\n  delete(scope: StateScope, key: string): boolean {\n    return this.values(scope).delete(validateKey(key));\n  }\n\n  clearScenario(): void {\n    this.scenarioValues.clear();\n  }\n\n  private values(scope: StateScope): StateValues {\n    if (scope === 'run') return this.runValues;\n    if (scope === 'feature') return this.featureValues;\n    return this.scenarioValues;\n  }\n}\n\nfunction validateKey(key: string): string {\n  const trimmed = key.trim();\n  if (!trimmed) throw new Error('BDD state key must not be empty');\n  return trimmed;\n}\n\nexport const sharedState = new SharedStateRegistry();\n"]}

package/dist/scoped-state.d.cts

@@ -0,0 +1,30 @@
+type StateScope = 'run' | 'feature' | 'scenario';
+type StateValues = Map<string, unknown>;
+/**
+ * Process-local state backing Behave-style run and feature context layers.
+ * Scenario values stay on the scenario World and are never shared.
+ */
+declare class SharedStateRegistry {
+    private readonly runValues;
+    private readonly featureValues;
+    run(): StateValues;
+    feature(featureUri: string): StateValues;
+    clear(): void;
+}
+/** Layered state lookup: scenario overrides feature, which overrides run. */
+declare class ScopedState {
+    private readonly runValues;
+    private readonly featureValues;
+    private readonly scenarioValues;
+    constructor(runValues: StateValues, featureValues: StateValues);
+    set<T>(scope: StateScope, key: string, value: T): T;
+    get<T>(key: string): T | undefined;
+    require<T>(key: string): T;
+    has(key: string): boolean;
+    delete(scope: StateScope, key: string): boolean;
+    clearScenario(): void;
+    private values;
+}
+declare const sharedState: SharedStateRegistry;
+
+export { ScopedState, SharedStateRegistry, type StateScope, sharedState };

package/dist/scoped-state.d.ts

@@ -0,0 +1,30 @@
+type StateScope = 'run' | 'feature' | 'scenario';
+type StateValues = Map<string, unknown>;
+/**
+ * Process-local state backing Behave-style run and feature context layers.
+ * Scenario values stay on the scenario World and are never shared.
+ */
+declare class SharedStateRegistry {
+    private readonly runValues;
+    private readonly featureValues;
+    run(): StateValues;
+    feature(featureUri: string): StateValues;
+    clear(): void;
+}
+/** Layered state lookup: scenario overrides feature, which overrides run. */
+declare class ScopedState {
+    private readonly runValues;
+    private readonly featureValues;
+    private readonly scenarioValues;
+    constructor(runValues: StateValues, featureValues: StateValues);
+    set<T>(scope: StateScope, key: string, value: T): T;
+    get<T>(key: string): T | undefined;
+    require<T>(key: string): T;
+    has(key: string): boolean;
+    delete(scope: StateScope, key: string): boolean;
+    clearScenario(): void;
+    private values;
+}
+declare const sharedState: SharedStateRegistry;
+
+export { ScopedState, SharedStateRegistry, type StateScope, sharedState };

package/dist/scoped-state.js

@@ -0,0 +1,3 @@
+export { ScopedState, SharedStateRegistry, sharedState } from './chunk-HTKRJLVX.js';
+//# sourceMappingURL=scoped-state.js.map
+//# sourceMappingURL=scoped-state.js.map

package/dist/scoped-state.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"scoped-state.js"}