laymos 0.0.1 → 0.0.2

package/dist/story/artifact/storage.js

@@ -1,162 +0,0 @@
-import { createHash } from 'node:crypto';
-import { mkdir, readFile, readdir, rm, unlink, writeFile, } from 'node:fs/promises';
-import { basename, join } from 'node:path';
-const storiesDirectory = '.laymos/stories';
-const rawDirectory = '.raw';
-export async function writeRawArtifact(baseDir, storyId, artifact) {
-    const directory = join(baseDir, storiesDirectory, rawDirectory);
-    await mkdir(directory, { recursive: true });
-    await writeFile(join(directory, `${Buffer.from(storyId).toString('base64url')}.json`), canonicalStringify({ storyId, artifact }));
-}
-export async function clearRawArtifacts(baseDir) {
-    await rm(join(baseDir, storiesDirectory, rawDirectory), {
-        recursive: true,
-        force: true,
-    });
-}
-export async function commitRawArtifacts(baseDir, complete) {
-    const directory = join(baseDir, storiesDirectory);
-    const raw = join(directory, rawDirectory);
-    await mkdir(directory, { recursive: true });
-    const existing = complete ? emptyIndex() : await getStoryIndex(baseDir);
-    const entries = new Map(Object.entries(existing.stories));
-    const committedStoryIds = new Set();
-    if (complete) {
-        for (const file of await listFiles(directory)) {
-            if (file.endsWith('.story.json') || file === 'index.json') {
-                await unlink(join(directory, file));
-            }
-        }
-    }
-    for (const file of (await listFiles(raw)).sort()) {
-        if (!file.endsWith('.json'))
-            continue;
-        const parsed = parseJson(await readFile(join(raw, file), 'utf8'), `raw Story artifact ${file}`);
-        if (typeof parsed.storyId !== 'string') {
-            throw new Error(`Raw Story artifact ${file} has no Story ID`);
-        }
-        const artifact = parseArtifact(parsed.artifact, file);
-        committedStoryIds.add(parsed.storyId);
-        const bytes = canonicalStringify(artifact);
-        const hash = createHash('sha256').update(bytes).digest('hex');
-        const artifactFile = `${storySlug(parsed.storyId)}-${hash}.story.json`;
-        await writeFile(join(directory, artifactFile), bytes);
-        const previous = entries.get(parsed.storyId);
-        if (previous !== undefined && previous.artifact !== artifactFile) {
-            await rm(join(directory, previous.artifact), { force: true });
-        }
-        entries.set(parsed.storyId, {
-            name: artifact.name,
-            description: artifact.description,
-            artifact: artifactFile,
-            generatedAt: artifact.generatedAt,
-        });
-    }
-    const index = {
-        schemaVersion: 2,
-        stories: Object.fromEntries([...entries].sort(([left], [right]) => left.localeCompare(right))),
-    };
-    await writeFile(join(directory, 'index.json'), canonicalStringify(index));
-    await rm(raw, { recursive: true, force: true });
-    return { index, committedStoryIds };
-}
-export async function getStoryIndex(baseDir) {
-    let bytes;
-    try {
-        bytes = await readFile(join(baseDir, storiesDirectory, 'index.json'), 'utf8');
-    }
-    catch (cause) {
-        if (isMissingFile(cause))
-            return emptyIndex();
-        throw cause;
-    }
-    const value = parseJson(bytes, 'Story index');
-    if (value.schemaVersion !== 2 || !isRecord(value.stories)) {
-        throw new Error('Story index is malformed or has an unsupported schema');
-    }
-    for (const [storyId, entry] of Object.entries(value.stories)) {
-        if (!isIndexEntry(entry)) {
-            throw new Error(`Story index entry "${storyId}" is malformed`);
-        }
-    }
-    return value;
-}
-export async function getStoryArtifact(baseDir, storyId) {
-    const index = await getStoryIndex(baseDir);
-    const entry = index.stories[storyId];
-    if (entry === undefined)
-        throw new Error(`Story "${storyId}" was not found`);
-    const bytes = await readFile(join(baseDir, storiesDirectory, entry.artifact), 'utf8');
-    const expectedHash = entry.artifact.match(/-([a-f0-9]{64})\.story\.json$/)?.[1];
-    const actualHash = createHash('sha256').update(bytes).digest('hex');
-    if (expectedHash === undefined || expectedHash !== actualHash) {
-        throw new Error(`Story artifact "${entry.artifact}" failed its hash check`);
-    }
-    return parseArtifact(parseJson(bytes, `Story artifact ${entry.artifact}`), entry.artifact);
-}
-function canonicalStringify(value) {
-    return JSON.stringify(sortValue(value));
-}
-function sortValue(value) {
-    if (Array.isArray(value))
-        return value.map(sortValue);
-    if (!isRecord(value))
-        return value;
-    return Object.fromEntries(Object.entries(value)
-        .sort(([left], [right]) => left.localeCompare(right))
-        .map(([key, item]) => [key, sortValue(item)]));
-}
-function parseArtifact(value, source) {
-    if (!isRecord(value) ||
-        value.schemaVersion !== 2 ||
-        typeof value.generatedAt !== 'number' ||
-        typeof value.name !== 'string' ||
-        typeof value.description !== 'string' ||
-        !isRecord(value.blocks) ||
-        !Array.isArray(value.scenarios)) {
-        throw new Error(`Story artifact ${source} is malformed`);
-    }
-    return value;
-}
-function parseJson(value, source) {
-    try {
-        return JSON.parse(value);
-    }
-    catch (cause) {
-        throw new Error(`${source} is not valid JSON`, { cause });
-    }
-}
-function storySlug(storyId) {
-    return basename(storyId)
-        .replace(/\.story\.[^.]+$/, '')
-        .replace(/[^a-z0-9-]+/g, '-');
-}
-function emptyIndex() {
-    return { schemaVersion: 2, stories: {} };
-}
-async function listFiles(directory) {
-    try {
-        return await readdir(directory);
-    }
-    catch (cause) {
-        if (isMissingFile(cause))
-            return [];
-        throw cause;
-    }
-}
-function isIndexEntry(value) {
-    return (isRecord(value) &&
-        typeof value.name === 'string' &&
-        typeof value.description === 'string' &&
-        typeof value.artifact === 'string' &&
-        typeof value.generatedAt === 'number');
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function isMissingFile(cause) {
-    return (typeof cause === 'object' &&
-        cause !== null &&
-        'code' in cause &&
-        cause.code === 'ENOENT');
-}

package/dist/story/artifact/types.d.ts

@@ -1,74 +0,0 @@
-export type StoryId = string;
-export type BlockId = string;
-export interface StorySourceLocation {
-    readonly file: string;
-    readonly line: number;
-    readonly column: number;
-}
-interface StoryBlockBase {
-    readonly name: string;
-    readonly description: string;
-    readonly location: StorySourceLocation;
-}
-export type StoryDecisionValue = string | number | boolean;
-export type StoryArm = {
-    readonly kind: 'literal';
-    readonly value: StoryDecisionValue;
-    readonly name: string;
-    readonly description: string;
-} | {
-    readonly kind: 'otherwise';
-    readonly name: string;
-    readonly description: string;
-};
-export type StoryBlock = (StoryBlockBase & {
-    readonly kind: 'block';
-}) | (StoryBlockBase & {
-    readonly kind: 'decision';
-    readonly arms: readonly StoryArm[];
-});
-export type ScenarioOutcome = 'succeeded' | 'failed' | 'interrupted' | 'skipped';
-export type StoryScenarioFailurePhase = 'preparation' | 'execution' | 'verification' | 'cleanup';
-export interface StoryScenarioFailure {
-    readonly phase: StoryScenarioFailurePhase;
-    readonly message: string;
-}
-export type StoryBlockVisitOutcome = 'succeeded' | 'failed' | 'interrupted';
-export type StorySelectedArm = {
-    readonly kind: 'literal';
-    readonly value: StoryDecisionValue;
-} | {
-    readonly kind: 'otherwise';
-};
-export type ExecutionPath = readonly ExecutionItem[];
-export type ExecutionItem = {
-    readonly blockId: BlockId;
-    readonly outcome: StoryBlockVisitOutcome;
-    readonly startOffsetMillis: number;
-    readonly durationMillis: number;
-    readonly selectedArm?: StorySelectedArm;
-    readonly attributes?: Readonly<Record<string, unknown>>;
-    readonly children: ExecutionPath;
-} | {
-    readonly parallel: readonly ExecutionPath[];
-};
-export interface StoryScenario {
-    readonly name: string;
-    readonly description: string;
-    readonly location: StorySourceLocation;
-    readonly outcome: ScenarioOutcome;
-    readonly startedAt?: number;
-    readonly durationMillis?: number;
-    readonly execution: ExecutionPath;
-    readonly failures: readonly StoryScenarioFailure[];
-}
-export interface StoryArtifact {
-    readonly schemaVersion: 3;
-    readonly generatedAt: number;
-    readonly name: string;
-    readonly description: string;
-    readonly blocks: Readonly<Record<BlockId, StoryBlock>>;
-    readonly scenarios: readonly StoryScenario[];
-}
-export {};
-//# sourceMappingURL=types.d.ts.map

package/dist/story/artifact/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/story/artifact/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAC7B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,MAAM,QAAQ,GAChB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,UAAU,GAClB,CAAC,cAAc,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,GAC7C,CAAC,cAAc,GAAG;IAChB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAC;CACpC,CAAC,CAAC;AAEP,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,QAAQ,GACR,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,MAAM,yBAAyB,GACjC,aAAa,GACb,WAAW,GACX,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE5E,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAEnC,MAAM,MAAM,aAAa,GAAG,SAAS,aAAa,EAAE,CAAC;AAErD,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC,GACD;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;CAC9C"}

package/dist/story/artifact/types.js

@@ -1 +0,0 @@
-export {};

package/dist/story/core/blocks.d.ts

@@ -1,20 +0,0 @@
-import type { ArmMeta, BlockMeta, DecisionValue } from './types.js';
-type AnyFunction = (...args: any[]) => any;
-export interface DecisionBuilder<Remaining extends DecisionValue, Result> {
-    when<Key extends Remaining, Next>(value: Key, body: (value: Key) => Next): DecisionBuilder<Exclude<Remaining, Key>, Result | Next>;
-    when<Key extends Remaining, Next>(value: Key, meta: ArmMeta, body: (value: Key) => Next): DecisionBuilder<Exclude<Remaining, Key>, Result | Next>;
-    otherwise<Next>(body: (value: Remaining) => Next): Result | Next;
-    otherwise<Next>(meta: ArmMeta, body: (value: Remaining) => Next): Result | Next;
-    readonly exhaustive: [Remaining] extends [never] ? () => Result : never;
-}
-/** Marks a reusable function boundary as a Story Block. */
-export declare function functionBlock<Fn extends AnyFunction>(name: string, fn: Fn): Fn;
-export declare function functionBlock<Fn extends AnyFunction>(name: string, meta: BlockMeta<Parameters<Fn>>, fn: Fn): Fn;
-/** Executes an inline Story Block. */
-export declare function step<R>(name: string, body: () => R): R;
-export declare function step<R>(name: string, meta: BlockMeta, body: () => R): R;
-/** Builds an eager, literal-keyed Story Decision. */
-export declare function decision<const Input extends DecisionValue>(name: string, input: Input): DecisionBuilder<Input, never>;
-export declare function decision<const Input extends DecisionValue>(name: string, meta: BlockMeta<[Input]>, input: Input): DecisionBuilder<Input, never>;
-export {};
-//# sourceMappingURL=blocks.d.ts.map

package/dist/story/core/blocks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../src/story/core/blocks.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpE,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAE3C,MAAM,WAAW,eAAe,CAAC,SAAS,SAAS,aAAa,EAAE,MAAM;IACtE,IAAI,CAAC,GAAG,SAAS,SAAS,EAAE,IAAI,EAC9B,KAAK,EAAE,GAAG,EACV,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GACzB,eAAe,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,IAAI,CAAC,GAAG,SAAS,SAAS,EAAE,IAAI,EAC9B,KAAK,EAAE,GAAG,EACV,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GACzB,eAAe,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACjE,SAAS,CAAC,IAAI,EACZ,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAC/B,MAAM,GAAG,IAAI,CAAC;IACjB,QAAQ,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,GAAG,KAAK,CAAC;CACzE;AA8ED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,EAAE,SAAS,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AAChF,wBAAgB,aAAa,CAAC,EAAE,SAAS,WAAW,EAClD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAC/B,EAAE,EAAE,EAAE,GACL,EAAE,CAAC;AAuBN,sCAAsC;AACtC,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AACxD,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AAmBzE,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,aAAa,EACxD,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,GACX,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACjC,wBAAgB,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,aAAa,EACxD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EACxB,KAAK,EAAE,KAAK,GACX,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC"}

package/dist/story/core/blocks.js

@@ -1,104 +0,0 @@
-import { captureLocation, getRecorder, resolveAttributes } from './recorder.js';
-class DecisionBuilderImpl {
-    state;
-    constructor(state) {
-        this.state = state;
-    }
-    when(value, metaOrBody, optionalBody) {
-        const meta = typeof metaOrBody === 'function' ? {} : metaOrBody;
-        const body = typeof metaOrBody === 'function' ? metaOrBody : optionalBody;
-        if (body === undefined)
-            throw new TypeError('Decision Arm body is required');
-        const arm = {
-            kind: 'literal',
-            value,
-            name: meta.name ?? String(value),
-            ...(meta.description === undefined
-                ? {}
-                : { description: meta.description }),
-        };
-        getRecorder()?.declareArm(this.state.block, arm);
-        if (!this.state.matched && Object.is(this.state.input, value)) {
-            this.state.matched = true;
-            this.state.result = runDecisionArm(this.state, { kind: 'literal', value }, () => body(value));
-        }
-        return this;
-    }
-    otherwise(metaOrBody, optionalBody) {
-        const meta = typeof metaOrBody === 'function' ? {} : metaOrBody;
-        const body = typeof metaOrBody === 'function' ? metaOrBody : optionalBody;
-        if (body === undefined)
-            throw new TypeError('Otherwise Arm body is required');
-        const arm = {
-            kind: 'otherwise',
-            name: meta.name ?? 'Otherwise',
-            ...(meta.description === undefined
-                ? {}
-                : { description: meta.description }),
-        };
-        getRecorder()?.declareArm(this.state.block, arm);
-        if (!this.state.matched) {
-            this.state.matched = true;
-            this.state.result = runDecisionArm(this.state, { kind: 'otherwise' }, () => body(this.state.input));
-        }
-        return this.state.result;
-    }
-    exhaustive() {
-        return this.state.result;
-    }
-}
-export function functionBlock(name, metaOrFn, optionalFn) {
-    const meta = typeof metaOrFn === 'function' ? {} : metaOrFn;
-    const fn = (typeof metaOrFn === 'function' ? metaOrFn : optionalFn);
-    if (fn === undefined)
-        throw new TypeError('Function Block body is required');
-    const block = makeBlock(name, meta, 'block');
-    return function (...args) {
-        const recorder = getRecorder();
-        if (recorder === undefined)
-            return fn.apply(this, args);
-        const attributes = resolveAttributes(meta.attributes, args);
-        return recorder.run(block, undefined, attributes, () => fn.apply(this, args));
-    };
-}
-export function step(name, metaOrBody, optionalBody) {
-    const meta = typeof metaOrBody === 'function' ? {} : metaOrBody;
-    const body = typeof metaOrBody === 'function' ? metaOrBody : optionalBody;
-    if (body === undefined)
-        throw new TypeError('Step body is required');
-    const recorder = getRecorder();
-    if (recorder === undefined)
-        return body();
-    return recorder.run(makeBlock(name, meta, 'block'), undefined, resolveAttributes(meta.attributes, []), body);
-}
-export function decision(name, metaOrInput, optionalInput) {
-    const hasMeta = typeof metaOrInput === 'object';
-    const meta = (hasMeta ? metaOrInput : {});
-    const input = (hasMeta ? optionalInput : metaOrInput);
-    if (input === undefined)
-        throw new TypeError('Decision value is required');
-    const state = {
-        block: makeBlock(name, meta, 'decision'),
-        input,
-        attributes: meta.attributes,
-        matched: false,
-        result: undefined,
-    };
-    return new DecisionBuilderImpl(state);
-}
-function makeBlock(name, meta, kind) {
-    return {
-        name,
-        kind,
-        location: captureLocation(),
-        ...(meta.description === undefined
-            ? {}
-            : { description: meta.description }),
-    };
-}
-function runDecisionArm(state, selectedArm, body) {
-    const recorder = getRecorder();
-    if (recorder === undefined)
-        return body();
-    return recorder.run(state.block, selectedArm, resolveAttributes(state.attributes, [state.input]), body);
-}

package/dist/story/core/declare.d.ts

@@ -1,63 +0,0 @@
-import type { SourceLocation } from './recorder.js';
-import type { StoryGroupMeta, StoryMeta } from './types.js';
-export type ScenarioExpectation = {
-    readonly kind: 'success';
-    readonly verify: (value: unknown, prepared: unknown) => unknown;
-} | {
-    readonly kind: 'error';
-    readonly verify: (error: unknown, prepared: unknown) => unknown;
-};
-interface ScenarioDeclarationBase {
-    readonly name: string;
-    readonly description: string;
-    readonly mode: 'run' | 'skip';
-    readonly location: SourceLocation;
-}
-export type ScenarioDeclaration = (ScenarioDeclarationBase & {
-    readonly mode: 'skip';
-}) | (ScenarioDeclarationBase & {
-    readonly mode: 'run';
-    readonly run: {
-        readonly prepare: () => unknown;
-        readonly expectation: ScenarioExpectation;
-        readonly cleanup?: (prepared: unknown) => unknown;
-        readonly timeout?: unknown;
-    };
-});
-export interface StoryExecution {
-    readonly execute: (prepared: unknown) => unknown;
-    readonly layer?: unknown;
-}
-export interface StoryDeclaration {
-    readonly name: string;
-    readonly description: string;
-    readonly group?: StoryGroupDeclaration;
-    readonly scenarios: readonly ScenarioDeclaration[];
-    readonly execution: StoryExecution | undefined;
-}
-export interface StoryGroupDeclaration {
-    readonly name: string;
-    readonly description: string;
-    readonly parent?: StoryGroupDeclaration;
-}
-export interface MutableStoryDeclaration {
-    readonly name: string;
-    readonly description: string;
-    readonly group?: StoryGroupDeclaration;
-    readonly scenarios: ScenarioDeclaration[];
-    execution: StoryExecution | undefined;
-}
-export type StoryCollector = (declaration: StoryDeclaration) => void;
-/** Declares the single Story owned by a Story file. */
-export declare function declareStory(name: string, meta: StoryMeta, group?: StoryGroupDeclaration): MutableStoryDeclaration;
-export declare function declareStoryGroup(name: string, meta: StoryGroupMeta, parent?: StoryGroupDeclaration): StoryGroupDeclaration;
-/** Adds a Scenario to a mutable Story declaration. */
-export declare function addScenario(declaration: MutableStoryDeclaration, scenario: Omit<Extract<ScenarioDeclaration, {
-    readonly mode: 'skip';
-}>, 'location'> | Omit<Extract<ScenarioDeclaration, {
-    readonly mode: 'run';
-}>, 'location'>): void;
-/** Runs `load` with a Story collector installed and returns what it declared. */
-export declare function collectDeclaredStories(load: () => Promise<unknown>): Promise<StoryDeclaration[]>;
-export {};
-//# sourceMappingURL=declare.d.ts.map

package/dist/story/core/declare.d.ts.map

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

package/dist/story/core/declare.js

@@ -1,62 +0,0 @@
-import { captureLocation } from './recorder.js';
-const collectorKey = Symbol.for('laymos/story-collector');
-const collectorHost = globalThis;
-/** Declares the single Story owned by a Story file. */
-export function declareStory(name, meta, group) {
-    requirePathSegment(name, 'Story');
-    requireDescription(meta.description, `Story "${name}"`);
-    const declaration = {
-        name,
-        description: meta.description,
-        ...(group === undefined ? {} : { group }),
-        scenarios: [],
-        execution: undefined,
-    };
-    collectorHost[collectorKey]?.(declaration);
-    return declaration;
-}
-export function declareStoryGroup(name, meta, parent) {
-    requirePathSegment(name, 'Story Group');
-    requireDescription(meta.description, `Story Group "${name}"`);
-    return {
-        name,
-        description: meta.description,
-        ...(parent === undefined ? {} : { parent }),
-    };
-}
-/** Adds a Scenario to a mutable Story declaration. */
-export function addScenario(declaration, scenario) {
-    requireDescription(scenario.description, `Scenario "${scenario.name}"`);
-    declaration.scenarios.push({
-        ...scenario,
-        location: captureLocation(),
-    });
-}
-function requireDescription(description, subject) {
-    if (description.trim().length === 0) {
-        throw new TypeError(`${subject} description must not be empty`);
-    }
-}
-function requirePathSegment(name, subject) {
-    if (name.trim().length === 0) {
-        throw new TypeError(`${subject} name must not be empty`);
-    }
-    if (name.includes('/')) {
-        throw new TypeError(`${subject} name "${name}" must not contain "/"`);
-    }
-}
-/** Runs `load` with a Story collector installed and returns what it declared. */
-export async function collectDeclaredStories(load) {
-    if (collectorHost[collectorKey] !== undefined) {
-        throw new Error('Story modules must be loaded sequentially');
-    }
-    const collected = [];
-    collectorHost[collectorKey] = (declaration) => collected.push(declaration);
-    try {
-        await load();
-        return collected;
-    }
-    finally {
-        delete collectorHost[collectorKey];
-    }
-}

package/dist/story/core/index.d.ts

@@ -1,4 +0,0 @@
-export { decision, functionBlock, step } from './blocks.js';
-export type { DecisionBuilder } from './blocks.js';
-export type { ArmMeta, Attributes, BlockMeta, DecisionValue } from './types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/story/core/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/story/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/story/core/index.js

@@ -1 +0,0 @@
-export { decision, functionBlock, step } from './blocks.js';

package/dist/story/core/recorder.d.ts

@@ -1,38 +0,0 @@
-import { Context } from 'effect';
-import type { Attributes, AttributesInput, DecisionValue } from './types.js';
-export interface SourceLocation {
-    readonly file: string;
-    readonly line: number;
-    readonly column: number;
-}
-export interface BlockDeclaration {
-    readonly name: string;
-    readonly description: string;
-    readonly kind: 'block' | 'decision';
-    readonly location: SourceLocation;
-}
-export type ArmDeclaration = {
-    readonly kind: 'literal';
-    readonly value: DecisionValue;
-    readonly name: string;
-    readonly description: string;
-} | {
-    readonly kind: 'otherwise';
-    readonly name: string;
-    readonly description: string;
-};
-export type SelectedArm = {
-    readonly kind: 'literal';
-    readonly value: DecisionValue;
-} | {
-    readonly kind: 'otherwise';
-};
-export interface StoryRecorder {
-    declareArm(block: BlockDeclaration, arm: ArmDeclaration): void;
-    start(block: BlockDeclaration, selectedArm: SelectedArm | undefined, attributes: Attributes | undefined, parent: unknown): unknown;
-    finish(token: unknown, outcome: 'succeeded' | 'failed' | 'interrupted'): void;
-}
-export declare const CurrentRecorder: Context.Reference<StoryRecorder | undefined>;
-export declare function resolveAttributes<Args extends readonly unknown[]>(input: AttributesInput<Args> | undefined, args: Args): Attributes | undefined;
-export declare function captureLocation(): SourceLocation;
-//# sourceMappingURL=recorder.d.ts.map

package/dist/story/core/recorder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../../src/story/core/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,MAAM,cAAc,GACtB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAEnC,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/D,KAAK,CACH,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,MAAM,EAAE,OAAO,GACd,OAAO,CAAC;IACX,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,IAAI,CAAC;CAC/E;AAED,eAAO,MAAM,eAAe,8CAG3B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,SAAS,OAAO,EAAE,EAC/D,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,GAAG,SAAS,EACxC,IAAI,EAAE,IAAI,GACT,UAAU,GAAG,SAAS,CAGxB;AAED,wBAAgB,eAAe,IAAI,cAAc,CAwBhD"}

package/dist/story/core/recorder.js

@@ -1,28 +0,0 @@
-import { Context } from 'effect';
-export const CurrentRecorder = Context.Reference('laymos/story/current-recorder', { defaultValue: () => undefined });
-export function resolveAttributes(input, args) {
-    if (input === undefined)
-        return undefined;
-    return typeof input === 'function' ? input(...args) : input;
-}
-export function captureLocation() {
-    const stack = new Error().stack?.split('\n').slice(1) ?? [];
-    for (const line of stack) {
-        if (line.includes('/story/core/') ||
-            line.includes('/story/effect/') ||
-            line.includes('/story/story-runtime/') ||
-            line.includes('/story/runner/') ||
-            line.includes('node:internal')) {
-            continue;
-        }
-        const match = line.match(/(?:\(|\s)(file:\/\/\/[^)\s]+|\/[^)\s]+):(\d+):(\d+)\)?$/);
-        if (match?.[1] !== undefined) {
-            return {
-                file: decodeURIComponent(match[1].replace(/^file:\/\//, '')),
-                line: Number(match[2]),
-                column: Number(match[3]),
-            };
-        }
-    }
-    return { file: '<unknown>', line: 0, column: 0 };
-}

package/dist/story/core/runtime-context.d.ts

@@ -1,14 +0,0 @@
-import type { MutableStoryDeclaration, StoryCollector } from './declare.js';
-import type { StoryRecorder } from './recorder.js';
-export interface StoryRuntimeContext {
-    readonly activeStory: MutableStoryDeclaration | undefined;
-    readonly collector: StoryCollector | undefined;
-    readonly recorder: StoryRecorder | undefined;
-}
-type StoryRuntimeContextUpdate = {
-    readonly [Key in keyof StoryRuntimeContext]?: StoryRuntimeContext[Key];
-};
-export declare function getStoryRuntimeContext(): StoryRuntimeContext;
-export declare function withStoryRuntimeContext<R>(update: StoryRuntimeContextUpdate, body: () => R): R;
-export {};
-//# sourceMappingURL=runtime-context.d.ts.map

package/dist/story/core/runtime-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../../src/story/core/runtime-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,cAAc,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;CAC9C;AAED,KAAK,yBAAyB,GAAG;IAC/B,QAAQ,EAAE,GAAG,IAAI,MAAM,mBAAmB,CAAC,CAAC,EAAE,mBAAmB,CAAC,GAAG,CAAC;CACvE,CAAC;AAcF,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,MAAM,EAAE,yBAAyB,EACjC,IAAI,EAAE,MAAM,CAAC,GACZ,CAAC,CAGH"}

package/dist/story/core/runtime-context.js

@@ -1,19 +0,0 @@
-import { AsyncLocalStorage } from 'node:async_hooks';
-const runtimeContextKey = Symbol.for('laymos/story-runtime-context');
-const emptyContext = {
-    activeStory: undefined,
-    collector: undefined,
-    recorder: undefined,
-};
-export function getStoryRuntimeContext() {
-    return getRuntimeContextStorage().getStore() ?? emptyContext;
-}
-export function withStoryRuntimeContext(update, body) {
-    const context = { ...getStoryRuntimeContext(), ...update };
-    return getRuntimeContextStorage().run(context, body);
-}
-function getRuntimeContextStorage() {
-    const host = globalThis;
-    host[runtimeContextKey] ??= new AsyncLocalStorage();
-    return host[runtimeContextKey];
-}

package/dist/story/core/types.d.ts

@@ -1,21 +0,0 @@
-export type DecisionValue = string | number | boolean;
-export type Attributes = Readonly<Record<string, unknown>>;
-export type AttributesInput<Args extends readonly unknown[]> = Attributes | ((...args: Args) => Attributes);
-export interface BlockMeta<Args extends readonly unknown[] = readonly []> {
-    readonly description: string;
-    readonly attributes?: AttributesInput<Args>;
-}
-export interface ArmMeta {
-    readonly name?: string;
-    readonly description: string;
-}
-export interface StoryMeta {
-    readonly description: string;
-}
-export interface StoryGroupMeta {
-    readonly description: string;
-}
-export interface ScenarioMeta {
-    readonly description: string;
-}
-//# sourceMappingURL=types.d.ts.map