laymos 0.0.1

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

@@ -0,0 +1,194 @@
+import { Cause, Context, Effect, Exit } from 'effect';
+import { addScenario, declareStoryGroup, declareStory, } from '../core/declare.js';
+import { captureLocation, CurrentRecorder, resolveAttributes, } from '../core/recorder.js';
+/** Declares the single Story owned by a Story file. */
+export function story(name, meta) {
+    return new EffectStoryBuilderImpl(declareStory(name, meta));
+}
+/** Declares a reusable Story Group. */
+export function storyGroup(name, meta) {
+    return new EffectStoryGroupImpl(declareStoryGroup(name, meta));
+}
+class EffectStoryGroupImpl {
+    declaration;
+    constructor(declaration) {
+        this.declaration = declaration;
+    }
+    group(name, meta) {
+        return new EffectStoryGroupImpl(declareStoryGroup(name, meta, this.declaration));
+    }
+    story(name, meta) {
+        return new EffectStoryBuilderImpl(declareStory(name, meta, this.declaration));
+    }
+}
+class EffectStoryBuilderImpl {
+    declaration;
+    constructor(declaration) {
+        this.declaration = declaration;
+    }
+    provide(layer) {
+        this.declaration.execution = {
+            execute: () => Effect.void,
+            layer,
+        };
+        return this;
+    }
+    execute(execute) {
+        const layer = this.declaration.execution?.layer;
+        this.declaration.execution = {
+            execute: execute,
+            ...(layer === undefined ? {} : { layer }),
+        };
+        return new EffectStoryImpl(this.declaration);
+    }
+}
+class EffectStoryImpl {
+    declaration;
+    constructor(declaration) {
+        this.declaration = declaration;
+    }
+    scenario(name, meta, define) {
+        const builder = new EffectScenarioBuilderImpl();
+        define(builder);
+        addScenario(this.declaration, {
+            name,
+            description: meta.description,
+            mode: 'run',
+            run: builder.build(meta.timeout),
+        });
+        return this;
+    }
+    skip(name, meta) {
+        addScenario(this.declaration, {
+            name,
+            description: meta.description,
+            mode: 'skip',
+        });
+        return this;
+    }
+}
+class EffectScenarioBuilderImpl {
+    preparation;
+    expectation;
+    cleanupBody;
+    prepare(prepare) {
+        this.preparation = prepare;
+        return this;
+    }
+    verify(verify) {
+        this.expectation = { kind: 'success', verify };
+        return this;
+    }
+    verifyError(verify) {
+        this.expectation = { kind: 'error', verify };
+        return this;
+    }
+    cleanup(cleanup) {
+        this.cleanupBody = cleanup;
+        return this;
+    }
+    build(timeout) {
+        if (this.preparation === undefined)
+            throw new TypeError('Scenario preparation is required');
+        if (this.expectation === undefined)
+            throw new TypeError('Scenario verification is required');
+        return {
+            prepare: this.preparation,
+            expectation: this.expectation,
+            ...(this.cleanupBody === undefined ? {} : { cleanup: this.cleanupBody }),
+            ...(timeout === undefined ? {} : { timeout }),
+        };
+    }
+}
+const CurrentVisit = Context.Reference('laymos/story/current-visit', { defaultValue: () => undefined });
+class DecisionBuilderImpl {
+    state;
+    constructor(state) {
+        this.state = state;
+    }
+    when(value, meta, body) {
+        requireDescription(meta.description, `Decision Arm "${meta.name ?? value}"`);
+        const arm = {
+            kind: 'literal',
+            value,
+            name: meta.name ?? String(value),
+            description: meta.description,
+        };
+        this.state.arms.push(arm);
+        if (!this.state.matched && Object.is(this.state.input, value)) {
+            this.state.matched = true;
+            this.state.selected = wrapEffect(this.state.block, { kind: 'literal', value }, () => resolveAttributes(this.state.attributes, [this.state.input]), body(value), this.state.arms);
+        }
+        return this;
+    }
+    otherwise(meta, body) {
+        requireDescription(meta.description, `Decision Arm "${meta.name ?? 'Otherwise'}"`);
+        const arm = {
+            kind: 'otherwise',
+            name: meta.name ?? 'Otherwise',
+            description: meta.description,
+        };
+        this.state.arms.push(arm);
+        if (!this.state.matched) {
+            this.state.matched = true;
+            this.state.selected = wrapEffect(this.state.block, { kind: 'otherwise' }, () => resolveAttributes(this.state.attributes, [this.state.input]), body(this.state.input), this.state.arms);
+        }
+        return this.state.selected;
+    }
+    exhaustive() {
+        return this.state.selected;
+    }
+    [Symbol.iterator]() {
+        return this.state.selected[Symbol.iterator]();
+    }
+}
+export function functionBlock(name, meta, fn) {
+    const block = makeBlock(name, meta, 'block');
+    return (...args) => wrapEffect(block, undefined, () => resolveAttributes(meta.attributes, args), fn(...args));
+}
+export function step(name, meta, effect) {
+    return wrapEffect(makeBlock(name, meta, 'block'), undefined, () => resolveAttributes(meta.attributes, []), effect);
+}
+export function decision(name, meta, input) {
+    return new DecisionBuilderImpl({
+        block: makeBlock(name, meta, 'decision'),
+        input,
+        attributes: meta.attributes,
+        arms: [],
+        matched: false,
+        selected: Effect.void,
+    });
+}
+function wrapEffect(block, selectedArm, attributes, effect, arms = []) {
+    return Effect.gen(function* () {
+        const recorder = yield* CurrentRecorder;
+        if (recorder === undefined)
+            return yield* effect;
+        for (const arm of arms)
+            recorder.declareArm(block, arm);
+        const parent = yield* CurrentVisit;
+        const token = recorder.start(block, selectedArm, attributes(), parent);
+        return yield* effect.pipe(Effect.onExit((exit) => Effect.sync(() => {
+            const outcome = Exit.isSuccess(exit)
+                ? 'succeeded'
+                : Cause.hasInterruptsOnly(exit.cause)
+                    ? 'interrupted'
+                    : 'failed';
+            recorder.finish(token, outcome);
+        })), Effect.provideService(CurrentVisit, token));
+    });
+}
+function makeBlock(name, meta, kind) {
+    requireDescription(meta.description, `${kind === 'decision' ? 'Decision' : 'Block'} "${name}"`);
+    return {
+        name,
+        kind,
+        location: captureLocation(),
+        description: meta.description,
+    };
+}
+function requireDescription(description, subject) {
+    if (description.trim().length === 0) {
+        throw new TypeError(`${subject} description must not be empty`);
+    }
+}

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

@@ -0,0 +1,29 @@
+import type { StoryMeta } from '../core/types.js';
+export { decision, functionBlock, step } from '../core/blocks.js';
+export type { DecisionBuilder } from '../core/blocks.js';
+export type { ArmMeta, Attributes, BlockMeta, DecisionValue, StoryMeta, } from '../core/types.js';
+export interface ScenarioMeta {
+    readonly description: string;
+    readonly timeoutMillis?: number;
+}
+export interface VanillaVerifiedScenario<Prepared> {
+    cleanup(cleanup: (prepared: Prepared, signal: AbortSignal) => void | Promise<void>): VanillaVerifiedScenario<Prepared>;
+}
+export interface VanillaPreparedScenario<Prepared, Output> {
+    cleanup(cleanup: (prepared: Prepared, signal: AbortSignal) => void | Promise<void>): VanillaPreparedScenario<Prepared, Output>;
+    verify(verify: (output: Output, prepared: Prepared) => void | Promise<void>): VanillaVerifiedScenario<Prepared>;
+    verifyError(verify: (error: unknown, prepared: Prepared) => void | Promise<void>): VanillaVerifiedScenario<Prepared>;
+}
+export interface VanillaScenario<Prepared, Output> {
+    prepare(prepare: (signal: AbortSignal) => Prepared | Promise<Prepared>): VanillaPreparedScenario<Prepared, Output>;
+}
+export interface VanillaStory<Prepared, Output> {
+    scenario(name: string, meta: ScenarioMeta, define: (scenario: VanillaScenario<Prepared, Output>) => VanillaVerifiedScenario<Prepared>): VanillaStory<Prepared, Output>;
+    skip(name: string, meta: ScenarioMeta): VanillaStory<Prepared, Output>;
+}
+export interface VanillaStoryBuilder {
+    execute<Prepared, Output>(execute: (prepared: Prepared, signal: AbortSignal) => Output | Promise<Output>): VanillaStory<Prepared, Output>;
+}
+/** Declares the single Story owned by a Story file. */
+export declare function story(name: string, meta: StoryMeta): VanillaStoryBuilder;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/story/vanilla/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EACV,OAAO,EACP,UAAU,EACV,SAAS,EACT,aAAa,EACb,SAAS,GACV,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB,CAAC,QAAQ;IAC/C,OAAO,CACL,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACzE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB,CAAC,QAAQ,EAAE,MAAM;IACvD,OAAO,CACL,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACzE,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,CACJ,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IACrC,WAAW,CACT,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,eAAe,CAAC,QAAQ,EAAE,MAAM;IAC/C,OAAO,CACL,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAC7D,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY,CAAC,QAAQ,EAAE,MAAM;IAC5C,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,CACN,QAAQ,EAAE,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,KACxC,uBAAuB,CAAC,QAAQ,CAAC,GACrC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,QAAQ,EAAE,MAAM,EACtB,OAAO,EAAE,CACP,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,WAAW,KAChB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAC5B,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,uDAAuD;AACvD,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,mBAAmB,CAExE"}

package/dist/story/vanilla/index.js

@@ -0,0 +1,78 @@
+import { addScenario, declareStory, } from '../core/declare.js';
+export { decision, functionBlock, step } from '../core/blocks.js';
+/** Declares the single Story owned by a Story file. */
+export function story(name, meta) {
+    return new VanillaStoryBuilderImpl(declareStory(name, meta));
+}
+class VanillaStoryBuilderImpl {
+    declaration;
+    constructor(declaration) {
+        this.declaration = declaration;
+    }
+    execute(execute) {
+        this.declaration.execution = {
+            kind: 'vanilla',
+            execute: execute,
+        };
+        return new VanillaStoryImpl(this.declaration);
+    }
+}
+class VanillaStoryImpl {
+    declaration;
+    constructor(declaration) {
+        this.declaration = declaration;
+    }
+    scenario(name, meta, define) {
+        const builder = new VanillaScenarioBuilderImpl();
+        define(builder);
+        addScenario(this.declaration, {
+            name,
+            description: meta.description,
+            mode: 'run',
+            run: builder.build(meta.timeoutMillis),
+        });
+        return this;
+    }
+    skip(name, meta) {
+        addScenario(this.declaration, {
+            name,
+            description: meta.description,
+            mode: 'skip',
+        });
+        return this;
+    }
+}
+class VanillaScenarioBuilderImpl {
+    preparation;
+    expectation;
+    cleanupBody;
+    prepare(prepare) {
+        this.preparation = prepare;
+        return this;
+    }
+    verify(verify) {
+        this.expectation = { kind: 'success', verify };
+        return this;
+    }
+    verifyError(verify) {
+        this.expectation = { kind: 'error', verify };
+        return this;
+    }
+    cleanup(cleanup) {
+        this.cleanupBody = cleanup;
+        return this;
+    }
+    build(timeoutMillis) {
+        if (this.preparation === undefined)
+            throw new TypeError('Scenario preparation is required');
+        if (this.expectation === undefined)
+            throw new TypeError('Scenario verification is required');
+        return {
+            kind: 'vanilla',
+            prepare: this.preparation,
+            expectation: this.expectation,
+            ...(this.cleanupBody === undefined ? {} : { cleanup: this.cleanupBody }),
+            ...(timeoutMillis === undefined ? {} : { timeoutMillis }),
+        };
+    }
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "laymos",
+  "version": "0.0.1",
+  "private": false,
+  "description": "Layers. Modules. Stories. Declare your architecture once; get enforcement and the diagram for free.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pkishorez/monorepo"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "default": "./dist/node.js"
+    },
+    "./report": {
+      "types": "./dist/report/index.d.ts",
+      "import": "./dist/report/index.js",
+      "default": "./dist/report/index.js"
+    },
+    "./story": {
+      "types": "./dist/story/effect/index.d.ts",
+      "import": "./dist/story/effect/index.js",
+      "default": "./dist/story/effect/index.js"
+    }
+  },
+  "bin": {
+    "laymos": "dist/cli/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@effect/platform-node": "4.0.0-beta.98",
+    "jiti": "2.7.0",
+    "skott": "0.35.11"
+  },
+  "devDependencies": {
+    "@typescript/native": "npm:typescript@7.0.2",
+    "@types/node": "26.1.1",
+    "effect": "4.0.0-beta.98",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "4.1.10"
+  },
+  "peerDependencies": {
+    "effect": "^4.0.0-beta.78"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "fmt": "vp fmt",
+    "lint": "vp check && tsc --noEmit",
+    "lint:laymos": "jiti src/cli/cli.ts lint",
+    "test": "vitest run"
+  }
+}