@haibun/core 1.75.2 → 2.0.0

package/build/currentVersion.d.ts

@@ -1,2 +1,2 @@
-export declare const currentVersion = "1.75.2";
+export declare const currentVersion = "2.0.0";
 //# sourceMappingURL=currentVersion.d.ts.map

package/build/currentVersion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"currentVersion.d.ts","sourceRoot":"","sources":["../src/currentVersion.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,WAAW,CAAC"}
+{"version":3,"file":"currentVersion.d.ts","sourceRoot":"","sources":["../src/currentVersion.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,UAAU,CAAC"}

package/build/currentVersion.js

@@ -1,2 +1,2 @@
-export const currentVersion = '1.75.2';
+export const currentVersion = '2.0.0';
 //# sourceMappingURL=currentVersion.js.map

package/build/currentVersion.js.map

@@ -1 +1 @@
-{"version":3,"file":"currentVersion.js","sourceRoot":"","sources":["../src/currentVersion.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"currentVersion.js","sourceRoot":"","sources":["../src/currentVersion.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC"}

package/build/lib/dependency-resolver.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dependency-resolver.d.ts.map

package/build/lib/dependency-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/dependency-resolver.ts"],"names":[],"mappings":""}

package/build/lib/dependency-resolver.js

@@ -0,0 +1,3 @@
+export {};
+// File intentionally left blank. DependencyResolver removed due to missing types.
+//# sourceMappingURL=dependency-resolver.js.map

package/build/lib/dependency-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolver.js","sourceRoot":"","sources":["../../src/lib/dependency-resolver.ts"],"names":[],"mappings":";AAAA,kFAAkF"}

package/build/lib/resolve-or-error.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve-or-error.d.ts.map

package/build/lib/resolve-or-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-or-error.d.ts","sourceRoot":"","sources":["../../src/lib/resolve-or-error.ts"],"names":[],"mappings":""}

package/build/lib/resolve-or-error.js

@@ -0,0 +1,3 @@
+export {};
+// File intentionally left blank. Dependency provider logic removed due to missing types.
+//# sourceMappingURL=resolve-or-error.js.map

package/build/lib/resolve-or-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-or-error.js","sourceRoot":"","sources":["../../src/lib/resolve-or-error.ts"],"names":[],"mappings":";AAAA,yFAAyF"}

package/build/lib/resolved-text-view.d.ts

@@ -0,0 +1,32 @@
+import { TResolvedFeature } from './defs.js';
+/**
+ * Generate a simple, flat text view of what actually runs
+ * Shows resolved variables inline, backgrounds expanded, etc.
+ * This is the "debuggable" linear view
+ */
+export type TLineMapping = {
+    displayLine: number;
+    sourcePath: string;
+    sourceContent: string;
+    isBackground: boolean;
+    seqPath: number[];
+    resolvedText: string;
+};
+/**
+ * Generate resolved text view with source mapping
+ */
+export declare function generateResolvedTextView(feature: TResolvedFeature): {
+    text: string;
+    lineMapping: TLineMapping[];
+};
+/**
+ * Get the mapping for a specific line in the resolved view
+ * Useful for "jump to source" features
+ */
+export declare function getSourceForLine(lineMapping: TLineMapping[], lineNumber: number): TLineMapping | undefined;
+/**
+ * Get all lines that came from a specific source file
+ * Useful for highlighting/filtering
+ */
+export declare function getLinesFromSource(lineMapping: TLineMapping[], sourcePath: string): TLineMapping[];
+//# sourceMappingURL=resolved-text-view.d.ts.map

package/build/lib/resolved-text-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-text-view.d.ts","sourceRoot":"","sources":["../../src/lib/resolved-text-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAgB,MAAM,WAAW,CAAC;AAE3D;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,YAAY,EAAE,CAAC;CAC5B,CAwDA;AA8CD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE1G;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAElG"}

package/build/lib/resolved-text-view.js

@@ -0,0 +1,103 @@
+/**
+ * Generate resolved text view with source mapping
+ */
+export function generateResolvedTextView(feature) {
+    const lines = [];
+    const lineMapping = [];
+    let lineNumber = 0;
+    // Header
+    lines.push(`# Resolved Feature: ${feature.path}`);
+    lines.push(`# Base: ${feature.base}`);
+    lines.push('');
+    // Dependencies
+    const deps = new Set(feature.featureSteps.map(s => s.path).filter(p => p !== feature.path));
+    if (deps.size > 0) {
+        lines.push('# Dependencies:');
+        deps.forEach(dep => lines.push(`#   ${dep}`));
+        lines.push('');
+    }
+    // Steps with resolved variables
+    for (const step of feature.featureSteps) {
+        lineNumber++;
+        // Get the display text with variables resolved
+        const resolvedText = resolveStepText(step);
+        const indent = '  '.repeat((step.seqPath?.length || 1) - 1);
+        const sourceMarker = step.path !== feature.path ? ` ← ${step.path}` : '';
+        const displayLine = `${indent}${resolvedText}${sourceMarker}`;
+        lines.push(displayLine);
+        lineMapping.push({
+            displayLine: lineNumber,
+            sourcePath: step.path,
+            sourceContent: step.in,
+            isBackground: step.path !== feature.path,
+            seqPath: step.seqPath || [],
+            resolvedText,
+        });
+        // Show resolved variables as comments
+        if (step.action.stepValuesMap) {
+            const vars = Object.entries(step.action.stepValuesMap)
+                .filter(([, v]) => !Array.isArray(v.value) && v.value !== undefined)
+                .map(([name, v]) => `${name}=${v.value}`);
+            if (vars.length > 0) {
+                lines.push(`${indent}  # [${vars.join(', ')}]`);
+            }
+        }
+    }
+    return {
+        text: lines.join('\n'),
+        lineMapping,
+    };
+}
+/**
+ * Resolve variables in step text to show actual values
+ */
+function resolveStepText(step) {
+    let text = step.in;
+    if (!step.action.stepValuesMap) {
+        return text;
+    }
+    // Replace each placeholder with its resolved value
+    for (const [name, valueInfo] of Object.entries(step.action.stepValuesMap)) {
+        // Skip complex nested values (like statement arrays)
+        if (Array.isArray(valueInfo.value))
+            continue;
+        if (valueInfo.value === undefined || valueInfo.value === null)
+            continue;
+        const displayValue = formatValue(valueInfo.value, valueInfo.origin);
+        // Try to replace the placeholder in the text
+        // This is a simple replacement - the original text might use {name} or other formats
+        const regex = new RegExp(`\\{${name}\\}|\\b${name}\\b`, 'g');
+        text = text.replace(regex, displayValue);
+    }
+    return text;
+}
+/**
+ * Format a value for display with source indicator
+ */
+function formatValue(value, origin) {
+    const stringValue = String(value);
+    // Add origin marker for clarity during debugging
+    switch (origin) {
+        case 'env':
+            return `${stringValue}⟨env⟩`;
+        case 'var':
+            return `${stringValue}⟨var⟩`;
+        default:
+            return stringValue;
+    }
+}
+/**
+ * Get the mapping for a specific line in the resolved view
+ * Useful for "jump to source" features
+ */
+export function getSourceForLine(lineMapping, lineNumber) {
+    return lineMapping.find(m => m.displayLine === lineNumber);
+}
+/**
+ * Get all lines that came from a specific source file
+ * Useful for highlighting/filtering
+ */
+export function getLinesFromSource(lineMapping, sourcePath) {
+    return lineMapping.filter(m => m.sourcePath === sourcePath);
+}
+//# sourceMappingURL=resolved-text-view.js.map

package/build/lib/resolved-text-view.js.map

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

package/build/lib/resolved-view.d.ts

@@ -0,0 +1,45 @@
+import { TResolvedFeature } from './defs.js';
+/**
+ * Generate a linear, human-readable view of a resolved feature
+ * showing exactly what will execute, with variables resolved
+ */
+export type TResolvedLine = {
+    lineNumber: number;
+    text: string;
+    sourcePath: string;
+    sourceLineNumber?: number;
+    seqPath: number[];
+    stepperName: string;
+    actionName: string;
+    variables?: Record<string, unknown>;
+};
+export type TResolvedView = {
+    featurePath: string;
+    lines: TResolvedLine[];
+    dependencies: string[];
+};
+/**
+ * Generate a flat, resolved view of a feature
+ * This is the "what actually runs" view
+ */
+export declare function generateResolvedView(feature: TResolvedFeature): TResolvedView;
+/**
+ * Generate a plain text version of the resolved view
+ * This is what you'd edit or debug
+ */
+export declare function formatResolvedViewAsText(view: TResolvedView): string;
+/**
+ * Generate an editable version with line mappings
+ * This allows changes to be synced back to source files
+ */
+export type TEditableResolvedView = {
+    text: string;
+    lineMapping: Array<{
+        editLine: number;
+        sourcePath: string;
+        sourceLineNumber?: number;
+        canEdit: boolean;
+    }>;
+};
+export declare function formatResolvedViewAsEditable(view: TResolvedView): TEditableResolvedView;
+//# sourceMappingURL=resolved-view.d.ts.map

package/build/lib/resolved-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-view.d.ts","sourceRoot":"","sources":["../../src/lib/resolved-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAgB,MAAM,WAAW,CAAC;AAE3D;;;GAGG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAgC7E;AA8DD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAmCpE;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,OAAO,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;CACH,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,aAAa,GAAG,qBAAqB,CAgBvF"}

package/build/lib/resolved-view.js

@@ -0,0 +1,133 @@
+/**
+ * Generate a flat, resolved view of a feature
+ * This is the "what actually runs" view
+ */
+export function generateResolvedView(feature) {
+    const lines = [];
+    const dependencies = new Set();
+    let lineNumber = 1;
+    for (const step of feature.featureSteps) {
+        // Track dependencies (backgrounds, etc)
+        if (step.path !== feature.path) {
+            dependencies.add(step.path);
+        }
+        // Get the display text with resolved variables
+        const text = resolveVariablesInText(step);
+        lines.push({
+            lineNumber: lineNumber++,
+            text,
+            sourcePath: step.path,
+            sourceLineNumber: undefined, // TODO: track original line number
+            seqPath: step.seqPath,
+            stepperName: step.action.stepperName,
+            actionName: step.action.actionName,
+            variables: extractVariables(step),
+        });
+    }
+    return {
+        featurePath: feature.path,
+        lines,
+        dependencies: Array.from(dependencies),
+    };
+}
+/**
+ * Resolve variables in the step text to show actual values
+ */
+function resolveVariablesInText(step) {
+    let text = step.in;
+    // If we have stepValuesMap, show the resolved values inline
+    if (step.action.stepValuesMap) {
+        const values = step.action.stepValuesMap;
+        for (const [placeholder, valueInfo] of Object.entries(values)) {
+            // Skip complex nested values
+            if (Array.isArray(valueInfo.value))
+                continue;
+            const displayValue = formatValueForDisplay(valueInfo.value, valueInfo.origin);
+            // Try to replace the placeholder in the text
+            // This is a simple approach - might need refinement
+            text = text.replace(new RegExp(`\\b${placeholder}\\b`, 'g'), displayValue);
+        }
+    }
+    return text;
+}
+/**
+ * Format a value for display, with source context
+ */
+function formatValueForDisplay(value, origin) {
+    if (value === null || value === undefined) {
+        return `<undefined>`;
+    }
+    const stringValue = String(value);
+    // Add origin indicator for clarity
+    switch (origin) {
+        case 'env':
+            return `${stringValue} (env)`;
+        case 'var':
+            return `${stringValue} (var)`;
+        default:
+            return stringValue;
+    }
+}
+/**
+ * Extract variable information for a step
+ */
+function extractVariables(step) {
+    if (!step.action.stepValuesMap)
+        return undefined;
+    const vars = {};
+    for (const [name, valueInfo] of Object.entries(step.action.stepValuesMap)) {
+        if (!Array.isArray(valueInfo.value)) {
+            vars[name] = valueInfo.value;
+        }
+    }
+    return Object.keys(vars).length > 0 ? vars : undefined;
+}
+/**
+ * Generate a plain text version of the resolved view
+ * This is what you'd edit or debug
+ */
+export function formatResolvedViewAsText(view) {
+    const lines = [];
+    lines.push(`# Feature: ${view.featurePath}`);
+    if (view.dependencies.length > 0) {
+        lines.push('');
+        lines.push('# Dependencies:');
+        for (const dep of view.dependencies) {
+            lines.push(`#   - ${dep}`);
+        }
+    }
+    lines.push('');
+    lines.push('# Resolved Steps:');
+    lines.push('');
+    for (const line of view.lines) {
+        const indent = '  '.repeat(line.seqPath.length - 1);
+        const sourceInfo = line.sourcePath !== view.featurePath
+            ? ` # from ${line.sourcePath}`
+            : '';
+        lines.push(`${indent}${line.text}${sourceInfo}`);
+        // Optionally show variables
+        if (line.variables && Object.keys(line.variables).length > 0) {
+            const varInfo = Object.entries(line.variables)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(', ');
+            lines.push(`${indent}  # vars: ${varInfo}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function formatResolvedViewAsEditable(view) {
+    const text = formatResolvedViewAsText(view);
+    const textLines = text.split('\n');
+    // Build line mapping (simplified for now)
+    const lineMapping = textLines.map((_, idx) => ({
+        editLine: idx + 1,
+        sourcePath: view.featurePath,
+        sourceLineNumber: undefined,
+        canEdit: true, // TODO: mark background lines as read-only
+    }));
+    return {
+        text,
+        lineMapping,
+    };
+}
+//# sourceMappingURL=resolved-view.js.map

package/build/lib/resolved-view.js.map

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

package/build/phases/statement.test copy.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=statement.test%20copy.d.ts.map

package/build/phases/statement.test copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statement.test copy.d.ts","sourceRoot":"","sources":["../../src/phases/statement.test copy.ts"],"names":[],"mappings":""}

package/build/phases/statement.test copy.js

@@ -0,0 +1,57 @@
+import { describe, it, expect } from 'vitest';
+import { AStepper } from '../lib/astepper.js';
+import { OK, ExecMode } from '../lib/defs.js';
+import { testWithDefaults, DEF_PROTO_OPTIONS } from '../lib/test/lib.js';
+import { actionNotOK } from '../lib/util/index.js';
+import { doExecuteFeatureSteps } from '../lib/util/featureStep-executor.js';
+import { DOMAIN_STATEMENT } from '../lib/domain-types.js';
+class StatementTestStepper extends AStepper {
+    steps = {
+        alpha: {
+            exact: 'alpha',
+            action: async () => Promise.resolve(OK),
+        },
+        beta: {
+            exact: 'beta',
+            action: async () => Promise.resolve(OK),
+        },
+        do: {
+            gwta: `do {steps:${DOMAIN_STATEMENT}}`,
+            action: async (args) => {
+                try {
+                    const steps = args.steps;
+                    if (!Array.isArray(steps))
+                        throw new Error('steps must be feature steps');
+                    const last = await doExecuteFeatureSteps(steps, [this], this.getWorld(), ExecMode.NO_CYCLES);
+                    if (!last || !last.ok) {
+                        const msg = last?.stepActionResult?.message || 'inline statement failed';
+                        return actionNotOK(`statement failed: ${msg}`);
+                    }
+                    return OK;
+                }
+                catch (e) {
+                    return actionNotOK(`statement failed: ${e.message}`);
+                }
+            }
+        }
+    };
+}
+describe('statement type', () => {
+    it('executes single known statement', async () => {
+        const feature = { path: '/features/test.feature', content: 'do alpha' };
+        const result = await testWithDefaults([feature], [StatementTestStepper], DEF_PROTO_OPTIONS, []);
+        expect(result.ok).toBe(true);
+    });
+    it('fails unknown statement', async () => {
+        const feature = { path: '/features/test.feature', content: 'do gamma' };
+        const result = await testWithDefaults([feature], [StatementTestStepper], DEF_PROTO_OPTIONS, []);
+        expect(result.ok).toBe(false);
+    });
+    it('executes multi-line backgrounds via statement list', async () => {
+        // Compose statement referencing beta after alpha
+        const feature = { path: '/features/test.feature', content: 'do alpha\nalpha\nbeta' };
+        const result = await testWithDefaults([feature], [StatementTestStepper], DEF_PROTO_OPTIONS, []);
+        expect(result.ok).toBe(true);
+    });
+});
+//# sourceMappingURL=statement.test%20copy.js.map

package/build/phases/statement.test copy.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@haibun/core",
   "type": "module",
-  "version": "1.75.2",
+  "version": "2.0.0",
   "description": "",
   "author": "",
   "exports": { "./*": "./build/*" },