laymos 0.0.1 → 0.0.3

package/dist/orchestrator/load-module-source/index.js

@@ -0,0 +1 @@
+export { loadModuleSource, ModuleSourceNotFound, ModuleSourceReadError, } from './load-module-source.js';

package/dist/orchestrator/load-module-source/load-module-source.d.ts

@@ -0,0 +1,12 @@
+import { Effect } from 'effect';
+import { ModuleSourceNotFound, ModuleSourceReadError } from './errors.js';
+export { ModuleSourceNotFound, ModuleSourceReadError } from './errors.js';
+export declare function loadModuleSource(configPath: string, modulePath: string): Effect.Effect<{
+    modulePath: string;
+    entryPoint?: string;
+    files: {
+        readonly path: string;
+        readonly content: string;
+    }[];
+}, import("../../services/config/errors.js").ConfigError | import("../../services/file-cruiser/errors.js").CruiseError | ModuleSourceNotFound | ModuleSourceReadError, never>;
+//# sourceMappingURL=load-module-source.d.ts.map

package/dist/orchestrator/load-module-source/load-module-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-module-source.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-module-source/load-module-source.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAc,MAAM,QAAQ,CAAC;AAO5C,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE1E,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;;;;;;;8KA0CtE"}

package/dist/orchestrator/load-module-source/load-module-source.js

@@ -0,0 +1,39 @@
+import { dirname, resolve } from 'node:path';
+import { NodeServices } from '@effect/platform-node';
+import { Effect, FileSystem } from 'effect';
+import { analyzeArchitecture } from '../../domain/architecture-analysis/index.js';
+import { ConfigServiceLive } from '../../services/config/index.js';
+import { CruiserLive } from '../../services/file-cruiser/index.js';
+import { loadProject } from '../load-project/index.js';
+import { ModuleSourceNotFound, ModuleSourceReadError } from './errors.js';
+export { ModuleSourceNotFound, ModuleSourceReadError } from './errors.js';
+export function loadModuleSource(configPath, modulePath) {
+    const absoluteConfigPath = resolve(configPath);
+    const baseDir = dirname(absoluteConfigPath);
+    return Effect.gen(function* () {
+        const { config, fileGraph } = yield* loadProject(absoluteConfigPath);
+        const analysis = analyzeArchitecture(fileGraph, config);
+        const module = analysis.moduleAnalysis.modules.find(({ path }) => path === modulePath);
+        if (module === undefined) {
+            return yield* new ModuleSourceNotFound({ modulePath });
+        }
+        const paths = [...analysis.moduleAnalysis.membership]
+            .filter(([, owner]) => owner === modulePath)
+            .map(([path]) => path)
+            .sort((left, right) => left.localeCompare(right));
+        const fileSystem = yield* FileSystem.FileSystem;
+        const files = yield* Effect.forEach(paths, (path) => fileSystem.readFileString(resolve(baseDir, path)).pipe(Effect.map((content) => ({ path, content })), Effect.mapError((cause) => new ModuleSourceReadError({ filePath: path, cause }))));
+        const rootEntryPoint = moduleEntryPoint(modulePath, analysis.moduleAnalysis.entryPoints);
+        return {
+            modulePath,
+            ...(rootEntryPoint === undefined ? {} : { entryPoint: rootEntryPoint }),
+            files,
+        };
+    }).pipe(Effect.provide(ConfigServiceLive), Effect.provide(CruiserLive), Effect.provide(NodeServices.layer));
+}
+function moduleEntryPoint(modulePath, entryPoints) {
+    if (entryPoints.has(modulePath))
+        return modulePath;
+    const directoryEntryPoint = `${modulePath}/index.ts`;
+    return entryPoints.has(directoryEntryPoint) ? directoryEntryPoint : undefined;
+}

package/dist/orchestrator/load-project/index.d.ts

@@ -0,0 +1,3 @@
+export { loadProject } from './load-project.js';
+export type { LoadedProject } from './load-project.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestrator/load-project/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-project/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/orchestrator/load-project/index.js

@@ -0,0 +1,2 @@
+// Architecture capabilities use this to load one Config and FileGraph.
+export { loadProject } from './load-project.js';

package/dist/orchestrator/load-project/load-project.d.ts

@@ -0,0 +1,54 @@
+import { Effect } from 'effect';
+import type { FileGraph } from '../../domain/file-graph/index.js';
+import { type Config } from '../../domain/project-config/index.js';
+import { ConfigError, ConfigService } from '../../services/config/index.js';
+import { Cruiser } from '../../services/file-cruiser/index.js';
+export interface LoadedProject {
+    readonly config: Config;
+    readonly fileGraph: FileGraph;
+}
+export declare function loadProject(configPath: string): Effect.Effect<{
+    config: {
+        readonly $schema?: string | undefined;
+        readonly sourceRoots: readonly string[];
+        readonly ignoredPaths: readonly string[];
+        readonly storiesPath?: string | undefined;
+        readonly layers: {
+            readonly [x: string]: {
+                readonly paths: readonly string[];
+                readonly description?: string | undefined;
+                readonly modules: {
+                    readonly [x: string]: {
+                        readonly shared: boolean;
+                        readonly exposed: boolean;
+                    };
+                };
+                readonly moduleGraphs: {
+                    readonly [x: string]: {
+                        readonly description?: string | undefined;
+                        readonly path: string;
+                        readonly modules: {
+                            readonly [x: string]: {
+                                readonly shared: boolean;
+                                readonly exposed: boolean;
+                            };
+                        };
+                        readonly rules: {
+                            readonly [x: string]: readonly string[];
+                        };
+                    };
+                };
+            };
+        };
+        readonly layerGraphs: {
+            readonly [x: string]: {
+                readonly description?: string | undefined;
+                readonly rules: {
+                    readonly [x: string]: readonly string[];
+                };
+            };
+        };
+    };
+    fileGraph: FileGraph;
+}, ConfigError | import("../../services/file-cruiser/errors.js").CruiseError, ConfigService | Cruiser>;
+//# sourceMappingURL=load-project.d.ts.map

package/dist/orchestrator/load-project/load-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-project.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/load-project/load-project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EACL,KAAK,MAAM,EAEZ,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uGA4B7C"}

package/dist/orchestrator/load-project/load-project.js

@@ -0,0 +1,30 @@
+import { dirname, resolve } from 'node:path';
+import { Effect } from 'effect';
+import { validateLoadedConfig, } from '../../domain/project-config/index.js';
+import { ConfigError, ConfigService } from '../../services/config/index.js';
+import { Cruiser } from '../../services/file-cruiser/index.js';
+export function loadProject(configPath) {
+    return Effect.gen(function* () {
+        const absoluteConfigPath = resolve(configPath);
+        const baseDir = dirname(absoluteConfigPath);
+        const configService = yield* ConfigService;
+        const config = yield* configService.read(absoluteConfigPath);
+        const cruiser = yield* Cruiser;
+        const fileGraph = yield* cruiser.cruise(baseDir, config.sourceRoots, config.storiesPath === undefined
+            ? config.ignoredPaths
+            : [...config.ignoredPaths, config.storiesPath]);
+        const issues = validateLoadedConfig(config, fileGraph.keys());
+        if (issues.length > 0) {
+            return yield* new ConfigError({
+                reason: 'validation',
+                filePath: absoluteConfigPath,
+                cause: issues,
+                issues,
+            });
+        }
+        return {
+            config,
+            fileGraph,
+        };
+    });
+}

package/dist/orchestrator/run-stories/errors.d.ts

@@ -0,0 +1,11 @@
+declare const StoriesError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "StoriesError";
+} & Readonly<A>;
+export declare class StoriesError extends StoriesError_base<{
+    readonly reason: 'no-stories-path' | 'load' | 'invalid-root' | 'duplicate-title' | 'duplicate-question' | 'snippet-extraction' | 'unknown-scope';
+    readonly path: string;
+    readonly cause: unknown;
+}> {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/orchestrator/run-stories/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/run-stories/errors.ts"],"names":[],"mappings":";;;AAEA,qBAAa,YAAa,SAAQ,kBAAiC;IACjE,QAAQ,CAAC,MAAM,EACX,iBAAiB,GACjB,MAAM,GACN,cAAc,GACd,iBAAiB,GACjB,oBAAoB,GACpB,oBAAoB,GACpB,eAAe,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG"}

package/dist/orchestrator/run-stories/errors.js

@@ -0,0 +1,3 @@
+import { Data } from 'effect';
+export class StoriesError extends Data.TaggedError('StoriesError') {
+}

package/dist/orchestrator/run-stories/extract-snippets.d.ts

@@ -0,0 +1,12 @@
+export interface StorySnippets {
+    readonly title: string | undefined;
+    readonly proofs: ReadonlyMap<string, string>;
+    readonly orderedProofs: readonly string[];
+}
+export interface ExtractedSnippets {
+    readonly setup: string | null;
+    readonly stories: readonly StorySnippets[];
+}
+export declare function extractSnippets(path: string, source: string): ExtractedSnippets;
+export declare function storySnippets(extracted: ExtractedSnippets, title: string): StorySnippets;
+//# sourceMappingURL=extract-snippets.d.ts.map

package/dist/orchestrator/run-stories/extract-snippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-snippets.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/run-stories/extract-snippets.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C;AAeD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,iBAAiB,CAsBnB;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,MAAM,GACZ,aAAa,CAIf"}

package/dist/orchestrator/run-stories/extract-snippets.js

@@ -0,0 +1,181 @@
+import { parseSync } from 'oxc-parser';
+export function extractSnippets(path, source) {
+    const program = parseSync(path, source).program;
+    const setupParts = [];
+    for (const statement of program.body) {
+        if (statement.type.startsWith('TSImport'))
+            continue;
+        if (statement.type === 'ImportDeclaration')
+            continue;
+        if (containsStoryCall(statement))
+            continue;
+        setupParts.push(source.slice(statement.start, statement.end));
+    }
+    const unscoped = newBucket(undefined);
+    const scoped = [];
+    collectProofs(program.body, source, unscoped, scoped);
+    const stories = [
+        ...scoped,
+        ...(unscoped.orderedProofs.length === 0 ? [] : [unscoped]),
+    ];
+    return {
+        setup: setupParts.length === 0 ? null : setupParts.join('\n\n'),
+        stories,
+    };
+}
+export function storySnippets(extracted, title) {
+    const matches = extracted.stories.filter((story) => story.title === title);
+    if (matches.length === 1)
+        return matches[0];
+    return mergeSnippets(matches.length > 1 ? matches : extracted.stories);
+}
+function mergeSnippets(stories) {
+    const merged = newBucket(undefined);
+    for (const story of stories) {
+        merged.orderedProofs.push(...story.orderedProofs);
+        for (const [question, proof] of story.proofs) {
+            merged.proofs.set(question, proof);
+        }
+    }
+    return merged;
+}
+function newBucket(title) {
+    return { title, proofs: new Map(), orderedProofs: [] };
+}
+function collectProofs(node, source, bucket, stories) {
+    if (Array.isArray(node)) {
+        for (const item of node)
+            collectProofs(item, source, bucket, stories);
+        return;
+    }
+    if (typeof node !== 'object' || node === null)
+        return;
+    const ast = node;
+    if (typeof ast.type !== 'string')
+        return;
+    let target = bucket;
+    if (isStoryCall(ast, 'make')) {
+        target = newBucket(storyTitle(ast));
+        stories.push(target);
+    }
+    else if (isStoryCall(ast, 'question')) {
+        const proof = questionProofSource(ast, source);
+        if (proof !== undefined) {
+            target.orderedProofs.push(proof);
+            const question = questionLiteral(ast);
+            if (question !== undefined)
+                target.proofs.set(question, proof);
+        }
+    }
+    for (const [key, value] of Object.entries(ast)) {
+        if (key === 'type' || key === 'start' || key === 'end')
+            continue;
+        collectProofs(value, source, target, stories);
+    }
+}
+function storyTitle(call) {
+    const argument = call.arguments?.[0];
+    if (argument?.type !== 'ObjectExpression')
+        return undefined;
+    for (const property of argument.properties ?? []) {
+        if (property.type !== 'Property')
+            continue;
+        if (propertyName(property) !== 'title')
+            continue;
+        return stringLiteral(property.value);
+    }
+    return undefined;
+}
+function isStoryCall(node, method) {
+    if (node.type !== 'CallExpression')
+        return false;
+    const callee = node.callee;
+    if (callee?.type !== 'MemberExpression')
+        return false;
+    const object = callee.object;
+    const property = callee.property;
+    return (object?.type === 'Identifier' &&
+        object.name === 'Story' &&
+        property?.type === 'Identifier' &&
+        property.name === method);
+}
+function propertyName(property) {
+    const key = property.key;
+    if (key?.type === 'Identifier')
+        return key.name;
+    if (key?.type === 'Literal')
+        return String(key.value);
+    return undefined;
+}
+function stringLiteral(node) {
+    if (node?.type === 'Literal') {
+        const value = node.value;
+        return typeof value === 'string' ? value : undefined;
+    }
+    if (node?.type === 'TemplateLiteral') {
+        const quasis = node.quasis;
+        if (quasis?.length === 1) {
+            const cooked = quasis[0]?.value?.cooked ?? quasis[0]?.cooked;
+            return typeof cooked === 'string' ? cooked : undefined;
+        }
+    }
+    return undefined;
+}
+function containsStoryCall(statement) {
+    let found = false;
+    const visit = (node) => {
+        if (found)
+            return;
+        if (Array.isArray(node)) {
+            for (const item of node)
+                visit(item);
+            return;
+        }
+        if (typeof node !== 'object' || node === null)
+            return;
+        const ast = node;
+        if (ast.type === 'MemberExpression' &&
+            ast.object?.type === 'Identifier' &&
+            ast.object.name === 'Story') {
+            found = true;
+            return;
+        }
+        for (const [key, value] of Object.entries(ast)) {
+            if (key === 'type' || key === 'start' || key === 'end')
+                continue;
+            visit(value);
+        }
+    };
+    visit(statement);
+    return found;
+}
+function questionLiteral(call) {
+    return stringLiteral(call.arguments?.[0]);
+}
+function questionProofSource(call, source) {
+    const options = call.arguments?.[1];
+    if (options?.type !== 'ObjectExpression')
+        return undefined;
+    for (const property of options.properties ?? []) {
+        if (property.type !== 'Property')
+            continue;
+        if (propertyName(property) !== 'proof')
+            continue;
+        const value = property.value;
+        if (value === undefined)
+            return undefined;
+        return dedent(source.slice(value.start, value.end));
+    }
+    return undefined;
+}
+function dedent(snippet) {
+    const lines = snippet.split('\n');
+    const indents = lines
+        .slice(1)
+        .filter((line) => line.trim().length > 0)
+        .map((line) => /^\s*/.exec(line)[0].length);
+    if (indents.length === 0)
+        return snippet;
+    const strip = Math.min(...indents);
+    return [lines[0], ...lines.slice(1).map((line) => line.slice(strip))].join('\n');
+}

package/dist/orchestrator/run-stories/index.d.ts

@@ -0,0 +1,3 @@
+export { getStoryTree, planStories, runStories } from './run-stories.js';
+export { StoriesError } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestrator/run-stories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/run-stories/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/orchestrator/run-stories/index.js

@@ -0,0 +1,3 @@
+// CLI and server consumers use this self-contained Stories run capability.
+export { getStoryTree, planStories, runStories } from './run-stories.js';
+export { StoriesError } from './errors.js';

package/dist/orchestrator/run-stories/run-stories.d.ts

@@ -0,0 +1,16 @@
+import { Effect, Stream } from 'effect';
+import type { StoryReport, StoryTree } from '../../story/schema/index.js';
+import type { ConfigError } from '../../services/config/index.js';
+import { StoriesError } from './errors.js';
+export declare function getStoryTree(configPath: string): Effect.Effect<StoryTree, ConfigError | StoriesError>;
+export interface RunStoriesOptions {
+    readonly scope?: string | undefined;
+    readonly concurrency?: number | undefined;
+}
+export interface StoriesRun {
+    readonly total: number;
+    readonly reports: Stream.Stream<StoryReport>;
+}
+export declare function planStories(configPath: string, options?: RunStoriesOptions): Effect.Effect<StoriesRun, ConfigError | StoriesError>;
+export declare function runStories(configPath: string, options?: RunStoriesOptions): Stream.Stream<StoryReport, ConfigError | StoriesError>;
+//# sourceMappingURL=run-stories.d.ts.map

package/dist/orchestrator/run-stories/run-stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-stories.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/run-stories/run-stories.ts"],"names":[],"mappings":"AAIA,OAAO,EAAS,MAAM,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAC;AAWrD,OAAO,KAAK,EAOV,WAAW,EAEX,SAAS,EAEV,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAUlE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,GAAG,YAAY,CAAC,CAEtD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;CAC9C;AAID,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,GAAG,YAAY,CAAC,CAYvD;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,YAAY,CAAC,CAIxD"}