create-relkit 0.7.11 → 0.8.0

package/dist/plan-builder-effects.js

@@ -1,172 +0,0 @@
-import { Effect, Ref } from "effect";
-import { observeExecution } from "@relkit/contracts/operation";
-import {} from "./add-types.js";
-import { finalizeManifestEffect } from "./plan-builder-manifest.js";
-import { planBuilderFiles } from "./plan-builder-files.js";
-/** Private Ref-backed Effect implementation inherited by the public compatibility owner. */
-export class PlanBuilderEffects {
-    request;
-    discovery;
-    #state;
-    #files;
-    /**
-     * Creates isolated planning state without sharing mutations with another request.
-     * @param request - Normalized scaffold request.
-     * @param discovery - Read-only discovery snapshot.
-     * @remarks Ref.makeUnsafe is required only by this existing synchronous constructor.
-     * @returns The invocation-owned instance.
-     */
-    constructor(request, discovery) {
-        this.request = request;
-        this.discovery = discovery;
-        this.#state = Ref.makeUnsafe({
-            files: new Map(),
-            dependencies: new Set(),
-            scripts: new Map(),
-            warnings: new Map(),
-            nextSteps: new Set(),
-            artifacts: [],
-            profiles: [],
-        });
-        this.#files = planBuilderFiles(this.#state, discovery);
-    }
-    /**
-     * Reads the planned source first, then the explicit filesystem service.
-     * @param path - Path inside the current project or owned resource.
-     * @returns Planned file text when present, otherwise text read through explicit filesystem authority.
-     */
-    readEffect = (path) => this.#files.readEffect(path);
-    /**
-     * Atomically reserves one create operation after checking the native destination.
-     * @param path - Path inside the current project or owned resource.
-     * @param content - Complete bytes or text planned for the destination.
-     * @param mode - Optional restored or generated permission mode.
-     * @returns Completion after collision preflight and atomic reservation of the new planned file.
-     */
-    createEffect = (path, content, mode) => this.#files.createEffect(path, content, mode);
-    /**
-     * Adds a source transformation to this request; transformations preserve expected validator errors.
-     * @param path - Path inside the current project or owned resource.
-     * @param transform - Pure transformation applied atomically to the latest planned source.
-     * @returns Completion after the transform is applied atomically to the latest planned source.
-     */
-    updateEffect = (path, transform) => this.#files.updateEffect(path, transform);
-    /**
-     * Plans an environment example only when the declaration is absent.
-     * @param name - Environment variable name.
-     * @param value - Example value used only for a new declaration.
-     * @returns An Effect planning the env example through explicit filesystem authority.
-     */
-    envExampleEffect = (name, value = "") => this.#files.envExampleEffect(name, value);
-    /**
-     * Plans a gitignore entry without duplicating an authored line.
-     * @param pattern - Declaration-owned glob or ignore pattern.
-     * @returns Completion after the missing ignore pattern is added to planned .gitignore source.
-     */
-    gitignoreEffect = (pattern) => this.#files.gitignoreEffect(pattern);
-    /**
-     * Records a required dependency through the authoritative request Ref.
-     * @param name - Authored name or declaration key.
-     * @returns Completion after the supported dependency is recorded in this request's Ref.
-     */
-    dependencyEffect = Effect.fn("PlanBuilder.dependency")((name) => Ref.update(this.#state, (state) => ({
-        ...state,
-        dependencies: new Set(state.dependencies).add(name),
-    })), (effect) => observeExecution("generator", "planning.dependency", effect));
-    /**
-     * Adds one artifact identity to the current request's discovery view.
-     * @param kind - Authoritative artifact kind.
-     * @param value - Artifact domain, source path, binding and optional identity/export form.
-     * @returns An observed Ref update registering the authoritative kind and projected artifact fields.
-     */
-    registerArtifactEffect = Effect.fn("PlanBuilder.registerArtifact")((kind, value) => Ref.update(this.#state, (state) => ({
-        ...state,
-        artifacts: [
-            ...state.artifacts,
-            {
-                kind,
-                domain: value.domain,
-                path: value.path,
-                binding: value.binding,
-                id: value.id,
-                factory: "scaffold",
-                exported: true,
-                exportKind: value.exportKind ?? "default",
-                options: [],
-            },
-        ],
-    })), (effect) => observeExecution("generator", "planning.registerArtifact", effect));
-    /**
-     * Adds one provider profile to the current request's discovery view.
-     * @param profile - Selected provider profile.
-     * @returns Completion after the discovered/planned profile projection is updated for this request.
-     */
-    registerProfileEffect = Effect.fn("PlanBuilder.registerProfile")((profile) => Ref.update(this.#state, (state) => ({ ...state, profiles: [...state.profiles, profile] })), (effect) => observeExecution("generator", "planning.registerProfile", effect));
-    /**
-     * Records one owned package script.
-     * @param name - Authored name or declaration key.
-     * @param command - Shell command stored under the package script name.
-     * @returns Completion after the script name and command are recorded for manifest planning.
-     */
-    scriptEffect = Effect.fn("PlanBuilder.script")((name, command) => Ref.update(this.#state, (state) => ({
-        ...state,
-        scripts: new Map(state.scripts).set(name, command),
-    })), (effect) => observeExecution("generator", "planning.script", effect));
-    /**
-     * Records a bounded warning by its stable code.
-     * @param code - Stable category code included in the resulting diagnostic.
-     * @param message - Existing user-facing diagnostic.
-     * @returns Completion after the warning is recorded under its stable category code.
-     */
-    warningEffect = Effect.fn("PlanBuilder.warning")((code, message) => Ref.update(this.#state, (state) => ({
-        ...state,
-        warnings: new Map(state.warnings).set(code, Object.freeze({ code, message })),
-    })), (effect) => observeExecution("generator", "planning.warning", effect));
-    /**
-     * Records one next command without duplicating it.
-     * @param command - Shell command shown as a follow-up instruction.
-     * @returns Completion after the follow-up command is deduplicated in request state.
-     */
-    nextStepEffect = Effect.fn("PlanBuilder.nextStep")((command) => Ref.update(this.#state, (state) => ({
-        ...state,
-        nextSteps: new Set(state.nextSteps).add(command),
-    })), (effect) => observeExecution("generator", "planning.nextStep", effect));
-    /**
-     * Finishes manifest ownership and returns a deterministic immutable plan.
-     * @returns The frozen plan containing ordered operations, concrete dependencies and public follow-up metadata.
-     */
-    finishEffect = Effect.fn("PlanBuilder.finish")(() => observeExecution("generator", "planning.finish", Effect.gen({ self: this }, function* () {
-        const dependencies = yield* finalizeManifestEffect(this, yield* Ref.get(this.#state));
-        const state = yield* Ref.get(this.#state);
-        return Object.freeze({
-            request: this.request,
-            projectRoot: this.discovery.projectRoot,
-            operations: Object.freeze([...state.files.values()].sort((a, b) => a.path.localeCompare(b.path))),
-            dependencies: Object.freeze(dependencies),
-            artifacts: Object.freeze(state.artifacts.map(({ kind, path, id, binding }) => ({
-                kind,
-                path,
-                id: id ?? binding,
-                binding,
-            }))),
-            profiles: Object.freeze(state.profiles.map(({ capability, name }) => ({ capability, name }))),
-            warnings: Object.freeze([...state.warnings.values()]),
-            nextSteps: Object.freeze([...state.nextSteps]),
-        });
-    })));
-    /**
-     * Returns a synchronous immutable projection of this request's authoritative Ref.
-     * @returns A new array combining discovered artifacts and this request's planned artifacts.
-     */
-    get artifacts() {
-        return [...this.discovery.artifacts, ...Ref.getUnsafe(this.#state).artifacts];
-    }
-    /**
-     * Returns a synchronous immutable profile projection of the request Ref.
-     * @returns A new array combining discovered profiles and this request's planned profiles.
-     */
-    get profiles() {
-        return [...this.discovery.profiles, ...Ref.getUnsafe(this.#state).profiles];
-    }
-}
-//# sourceMappingURL=plan-builder-effects.js.map

package/dist/plan-builder-effects.js.map

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

package/dist/plan-builder-files.d.ts

@@ -1,12 +0,0 @@
-import { Ref } from "effect";
-import type { ProjectDiscovery } from "./project-discovery-types.js";
-import type { PlanBuilderState } from "./plan-builder.types.js";
-import type { PlanBuilderFileOperations } from "./plan-builder-files.types.js";
-/**
- * Creates private file-planning capabilities for one request Ref.
- * @param state - The request owner's private authoritative Ref.
- * @param discovery - Immutable declaration facts establishing the project root.
- * @returns File Effects retaining explicit filesystem authority and atomic Ref updates.
- */
-export declare function planBuilderFiles(state: Ref.Ref<PlanBuilderState>, discovery: ProjectDiscovery): PlanBuilderFileOperations;
-//# sourceMappingURL=plan-builder-files.d.ts.map

package/dist/plan-builder-files.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan-builder-files.d.ts","sourceRoot":"","sources":["../src/plan-builder-files.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,GAAG,EAAE,MAAM,QAAQ,CAAC;AAGrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/E;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,gBAAgB,6BA+G7F"}

package/dist/plan-builder-files.js

@@ -1,99 +0,0 @@
-import { resolve } from "node:path";
-import { Effect, Ref } from "effect";
-import { observeExecution } from "@relkit/contracts/operation";
-import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
-import { GeneratorFileSystem } from "./generator-filesystem.js";
-import { domainError, scaffoldErrors } from "./generator-errors.js";
-/**
- * Creates private file-planning capabilities for one request Ref.
- * @param state - The request owner's private authoritative Ref.
- * @param discovery - Immutable declaration facts establishing the project root.
- * @returns File Effects retaining explicit filesystem authority and atomic Ref updates.
- */
-export function planBuilderFiles(state, discovery) {
-    const operations = {
-        /** Reads the planned source first, then the explicit filesystem service. */
-        readEffect: Effect.fn("PlanBuilder.read")((path) => Effect.gen(function* () {
-            const planned = (yield* Ref.get(state)).files.get(path);
-            if (planned !== undefined)
-                return planned.content;
-            return yield* (yield* GeneratorFileSystem).readText(resolve(discovery.projectRoot, path));
-        }), (effect) => observeExecution("generator", "planning.read", effect)),
-        /** Atomically reserves one create operation after checking the native destination. */
-        createEffect: Effect.fn("PlanBuilder.create")((path, content, mode) => Effect.gen(function* () {
-            const fs = yield* GeneratorFileSystem;
-            if ((yield* fs.metadata(resolve(discovery.projectRoot, path))) !== undefined)
-                return yield* collision(`${path} already exists.`);
-            const duplicate = yield* Ref.modify(state, (state) => state.files.has(path)
-                ? [true, state]
-                : [
-                    false,
-                    {
-                        ...state,
-                        files: new Map(state.files).set(path, {
-                            path,
-                            action: "create",
-                            content,
-                            ...(mode === undefined ? {} : { mode }),
-                        }),
-                    },
-                ]);
-            if (duplicate)
-                return yield* collision(`${path} already exists.`);
-        }), (effect) => observeExecution("generator", "planning.create", effect)),
-        /** Adds a source transformation to this request; transformations preserve expected validator errors. */
-        updateEffect: Effect.fn("PlanBuilder.update")((path, transform) => Effect.gen(function* () {
-            const source = yield* operations
-                .readEffect(path)
-                .pipe(Effect.mapError(() => domainError(new AddScaffoldError(ADD_FAILURE_CODES.invalidProject, `${path} does not exist.`))));
-            yield* Ref.update(state, (state) => {
-                const existing = state.files.get(path);
-                const current = existing?.content ?? source;
-                const content = transform(current);
-                return content === current
-                    ? state
-                    : {
-                        ...state,
-                        files: new Map(state.files).set(path, {
-                            path,
-                            action: existing?.action ?? "update",
-                            content,
-                            ...(existing?.mode === undefined ? {} : { mode: existing.mode }),
-                        }),
-                    };
-            }).pipe(scaffoldErrors);
-        }), (effect) => observeExecution("generator", "planning.update", effect)),
-        /** Plans an environment example without replacing an existing declaration. */
-        envExampleEffect: Effect.fn("PlanBuilder.envExample")((name, value = "") => operations.appendLineEffect(".env.example", `${name}=${value}`, (source) => new RegExp(`^${escape(name)}=`, "m").test(source)), (effect) => observeExecution("generator", "planning.envExample", effect)),
-        /** Plans a gitignore entry without duplicating an authored line. */
-        gitignoreEffect: Effect.fn("PlanBuilder.gitignore")((pattern) => operations.appendLineEffect(".gitignore", pattern, (source) => source.split(/\r?\n/).includes(pattern)), (effect) => observeExecution("generator", "planning.gitignore", effect)),
-        /** Adds an owned line only when absent from planned and native source. */
-        appendLineEffect: Effect.fn("PlanBuilder.appendLine")((path, line, present) => Effect.gen(function* () {
-            if (!(yield* Ref.get(state)).files.has(path) &&
-                (yield* (yield* GeneratorFileSystem).metadata(resolve(discovery.projectRoot, path))) ===
-                    undefined) {
-                yield* operations.createEffect(path, `${line}\n`);
-            }
-            else
-                yield* operations.updateEffect(path, (source) => present(source) ? source : `${source.trimEnd()}\n${line}\n`);
-        }), (effect) => observeExecution("generator", "planning.appendLine", effect)),
-    };
-    return operations;
-}
-/**
- * Constructs a typed collision failure preserving its public constructor.
- * @param message - Diagnostic explaining the conflicting declaration.
- * @returns An Effect failing with the original RELKIT_ADD_COLLISION AddScaffoldError.
- */
-function collision(message) {
-    return Effect.fail(domainError(new AddScaffoldError(ADD_FAILURE_CODES.collision, message)));
-}
-/**
- * Escapes a generated environment name for a pure declaration-presence check.
- * @param value - Environment name embedded in a declaration-presence expression.
- * @returns The value with regular-expression metacharacters escaped.
- */
-function escape(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-//# sourceMappingURL=plan-builder-files.js.map

package/dist/plan-builder-files.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan-builder-files.js","sourceRoot":"","sources":["../src/plan-builder-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIpE;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgC,EAAE,SAA2B;IAC5F,MAAM,UAAU,GAA8B;QAC5C,4EAA4E;QAC5E,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,kBAAkB,CAAC,CACvC,CAAC,IAAY,EAAE,EAAE,CACf,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxD,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC;YAClD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5F,CAAC,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,eAAe,EAAE,MAAM,CAAC,CACnE;QAED,sFAAsF;QACtF,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAC3C,CAAC,IAAY,EAAE,OAAe,EAAE,IAAa,EAAE,EAAE,CAC/C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;gBAC1E,OAAO,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,kBAAkB,CAAC,CAAC;YACrD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACnD,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;gBACnB,CAAC,CAAE,CAAC,IAAI,EAAE,KAAK,CAAW;gBAC1B,CAAC,CAAE;oBACC,KAAK;oBACL;wBACE,GAAG,KAAK;wBACR,KAAK,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE;4BACpC,IAAI;4BACJ,MAAM,EAAE,QAAQ;4BAChB,OAAO;4BACP,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;yBACxC,CAAC;qBACH;iBACQ,CAChB,CAAC;YACF,IAAI,SAAS;gBAAE,OAAO,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,kBAAkB,CAAC,CAAC;QACpE,CAAC,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,EAAE,MAAM,CAAC,CACrE;QAED,wGAAwG;QACxG,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAC3C,CAAC,IAAY,EAAE,SAAqC,EAAE,EAAE,CACtD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,UAAU;iBAC7B,UAAU,CAAC,IAAI,CAAC;iBAChB,IAAI,CACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CACnB,WAAW,CACT,IAAI,gBAAgB,CAAC,iBAAiB,CAAC,cAAc,EAAE,GAAG,IAAI,kBAAkB,CAAC,CAClF,CACF,CACF,CAAC;YACJ,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;gBACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACvC,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,MAAM,CAAC;gBAC5C,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;gBACnC,OAAO,OAAO,KAAK,OAAO;oBACxB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC;wBACE,GAAG,KAAK;wBACR,KAAK,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE;4BACpC,IAAI;4BACJ,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,QAAQ;4BACpC,OAAO;4BACP,GAAG,CAAC,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;yBACjE,CAAC;qBACH,CAAC;YACR,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1B,CAAC,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,EAAE,MAAM,CAAC,CACrE;QAED,8EAA8E;QAC9E,gBAAgB,EAAE,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,CACnD,CAAC,IAAY,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAC3B,UAAU,CAAC,gBAAgB,CAAC,cAAc,EAAE,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CACzE,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAClD,EACH,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,qBAAqB,EAAE,MAAM,CAAC,CACzE;QAED,oEAAoE;QACpE,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,CACjD,CAAC,OAAe,EAAE,EAAE,CAClB,UAAU,CAAC,gBAAgB,CAAC,YAAY,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAC5D,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CACxC,EACH,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,oBAAoB,EAAE,MAAM,CAAC,CACxE;QAED,0EAA0E;QAC1E,gBAAgB,EAAE,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,CACnD,CAAC,IAAY,EAAE,IAAY,EAAE,OAAoC,EAAE,EAAE,CACnE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,IACE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;gBACxC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;oBAClF,SAAS,EACX,CAAC;gBACD,KAAK,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;YACpD,CAAC;;gBACC,KAAK,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAC9C,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAC5D,CAAC;QACN,CAAC,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,qBAAqB,EAAE,MAAM,CAAC,CACzE;KACF,CAAC;IACF,OAAO,UAAU,CAAC;AACpB,CAAC;AACD;;;;GAIG;AACH,SAAS,SAAS,CAAC,OAAe;IAChC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,gBAAgB,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED;;;;GAIG;AACH,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC"}

package/dist/plan-builder-files.types.d.ts

@@ -1,49 +0,0 @@
-import type { Effect } from "effect";
-import type { GeneratorFileSystem } from "./generator-filesystem.js";
-import type { GeneratorDomainError, GeneratorIoError } from "./generator-errors.js";
-/** File-planning capabilities retaining their exact native read requirement. */
-export interface PlanBuilderFileOperations {
-    /**
-     * Composes read with explicit services, typed failures and owned resource lifetime.
-     * @param path - Path inside the current project or owned resource.
-     * @returns Planned file text when present, otherwise text read through explicit filesystem authority.
-     */
-    readonly readEffect: (path: string) => Effect.Effect<string, GeneratorIoError, GeneratorFileSystem>;
-    /**
-     * Composes create with explicit services, typed failures and owned resource lifetime.
-     * @param path - Path inside the current project or owned resource.
-     * @param content - Complete bytes or text planned for the destination.
-     * @param mode - Optional restored or generated permission mode.
-     * @returns Completion after collision preflight and atomic reservation of the new planned file.
-     */
-    readonly createEffect: (path: string, content: string, mode?: number) => Effect.Effect<void, GeneratorDomainError | GeneratorIoError, GeneratorFileSystem>;
-    /**
-     * Composes update with explicit services, typed failures and owned resource lifetime.
-     * @param path - Path inside the current project or owned resource.
-     * @param transform - Pure transformation applied atomically to the latest planned source.
-     * @returns Completion after the transform is applied atomically to the latest planned source.
-     */
-    readonly updateEffect: (path: string, transform: (source: string) => string) => Effect.Effect<void, GeneratorDomainError | GeneratorIoError, GeneratorFileSystem>;
-    /**
-     * Composes append Line with explicit services, typed failures and owned resource lifetime.
-     * @param path - Path inside the current project or owned resource.
-     * @param line - Complete owned line to append.
-     * @param present - Pure predicate detecting an already authored line.
-     * @returns Completion after a missing line is added without replacing an existing matching declaration.
-     */
-    readonly appendLineEffect: (path: string, line: string, present: (source: string) => boolean) => Effect.Effect<void, GeneratorDomainError | GeneratorIoError, GeneratorFileSystem>;
-    /**
-     * Plans an environment example only when the declaration is absent.
-     * @param name - Environment variable name.
-     * @param value - Example value used only for a new declaration.
-     * @returns An Effect planning the env example through explicit filesystem authority.
-     */
-    readonly envExampleEffect: (name: string, value?: string) => Effect.Effect<void, GeneratorDomainError | GeneratorIoError, GeneratorFileSystem>;
-    /**
-     * Composes gitignore with explicit services, typed failures and owned resource lifetime.
-     * @param pattern - Declaration-owned glob or ignore pattern.
-     * @returns Completion after the missing ignore pattern is added to planned .gitignore source.
-     */
-    readonly gitignoreEffect: (pattern: string) => Effect.Effect<void, GeneratorDomainError | GeneratorIoError, GeneratorFileSystem>;
-}
-//# sourceMappingURL=plan-builder-files.types.d.ts.map

package/dist/plan-builder-files.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan-builder-files.types.d.ts","sourceRoot":"","sources":["../src/plan-builder-files.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,gFAAgF;AAChF,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,CACnB,IAAI,EAAE,MAAM,KACT,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IAClE;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IACvF;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,KAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IACvF;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,KACjC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IACvF;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CACzB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IACvF;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,CACxB,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;CACxF"}

package/dist/plan-builder-files.types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=plan-builder-files.types.js.map

package/dist/plan-builder-files.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan-builder-files.types.js","sourceRoot":"","sources":["../src/plan-builder-files.types.ts"],"names":[],"mappings":""}

package/dist/plan-builder-manifest.d.ts

@@ -1,11 +0,0 @@
-import { Effect } from "effect";
-import type { PlanBuilderEffects } from "./plan-builder-effects.js";
-import type { PlanBuilderState } from "./plan-builder.types.js";
-/**
- * Finishes dependencies, scripts and portable patches before transaction mutation begins.
- * @param builder - Request owner whose state remains authoritative in its Ref.
- * @param state - Read-only snapshot passed by the private request-state owner.
- * @returns Newly introduced concrete dependencies; patch-only repair remains file operations.
- */
-export declare const finalizeManifestEffect: (builder: PlanBuilderEffects, state: PlanBuilderState) => Effect.Effect<Record<string, string>, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, import("./generator-filesystem.js").GeneratorFileSystem>;
-//# sourceMappingURL=plan-builder-manifest.d.ts.map

package/dist/plan-builder-manifest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan-builder-manifest.d.ts","sourceRoot":"","sources":["../src/plan-builder-manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMhC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,mQAiDlC,CAAC"}

package/dist/plan-builder-manifest.js

@@ -1,37 +0,0 @@
-import { observeExecution } from "@relkit/contracts/operation";
-import { Effect } from "effect";
-import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
-import { domainError, domainTry } from "./generator-errors.js";
-import { mergeScaffoldManifest, scaffoldManifestDependencies } from "./plan-manifest.js";
-import { planDependencyPatchEffect, readDrizzlePatchEffect } from "./dependency-patches.js";
-import { resolveProjectDependenciesEffect } from "./project-catalog.js";
-/**
- * Finishes dependencies, scripts and portable patches before transaction mutation begins.
- * @param builder - Request owner whose state remains authoritative in its Ref.
- * @param state - Read-only snapshot passed by the private request-state owner.
- * @returns Newly introduced concrete dependencies; patch-only repair remains file operations.
- */
-export const finalizeManifestEffect = Effect.fn("PlanBuilder.finalizeManifest")(function* (builder, state) {
-    const source = yield* builder.readEffect("package.json");
-    const declared = yield* domainTry(() => scaffoldManifestDependencies(source));
-    const requested = Object.fromEntries([...state.dependencies].flatMap((name) => declared[name] === undefined ? [] : [[name, declared[name]]]));
-    const resolved = yield* resolveProjectDependenciesEffect(builder.discovery.projectRoot, requested);
-    const result = yield* domainTry(() => state.dependencies.size === 0 && state.scripts.size === 0
-        ? { content: source, added: {} }
-        : mergeScaffoldManifest(source, state.dependencies, state.scripts, resolved));
-    let content = result.content;
-    const dependencies = new Set([...state.dependencies, ...Object.keys(declared)]);
-    if (["drizzle-orm", "@relkit/drizzle", "@relkit/testing", "@relkit/effect-mq"].some((name) => dependencies.has(name))) {
-        const patch = yield* readDrizzlePatchEffect();
-        const planned = state.files.get(patch.path);
-        if (planned !== undefined && planned.content !== patch.content)
-            return yield* Effect.fail(domainError(new AddScaffoldError(ADD_FAILURE_CODES.collision, `${patch.path} already contains a different planned dependency patch.`)));
-        const patched = yield* planDependencyPatchEffect(builder.discovery.projectRoot, content, patch);
-        content = patched.content;
-        if (patched.operation !== undefined && planned === undefined)
-            yield* builder.createEffect(patched.operation.path, patched.operation.content);
-    }
-    yield* builder.updateEffect("package.json", () => content);
-    return result.added;
-}, (effect) => observeExecution("generator", "planning.finalizeManifest", effect));
-//# sourceMappingURL=plan-builder-manifest.js.map

package/dist/plan-builder-manifest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan-builder-manifest.js","sourceRoot":"","sources":["../src/plan-builder-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAIxE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,EAAE,CAAC,8BAA8B,CAAC,CAC7E,QAAQ,CAAC,EAAE,OAA2B,EAAE,KAAuB;IAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAClC,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACvC,QAAQ,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAC7D,CACF,CAAC;IACF,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,gCAAgC,CACtD,OAAO,CAAC,SAAS,CAAC,WAAW,EAC7B,SAAS,CACV,CAAC;IACF,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,CACnC,KAAK,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;QACvD,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;QAChC,CAAC,CAAC,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAC/E,CAAC;IACF,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC7B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,KAAK,CAAC,YAAY,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxF,IACE,CAAC,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACvF,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CACvB,EACD,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,sBAAsB,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;YAC5D,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,WAAW,CACT,IAAI,gBAAgB,CAClB,iBAAiB,CAAC,SAAS,EAC3B,GAAG,KAAK,CAAC,IAAI,yDAAyD,CACvE,CACF,CACF,CAAC;QACJ,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,yBAAyB,CAC9C,OAAO,CAAC,SAAS,CAAC,WAAW,EAC7B,OAAO,EACP,KAAK,CACN,CAAC;QACF,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC1B,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;YAC1D,KAAK,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACnF,CAAC;IACD,KAAK,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,2BAA2B,EAAE,MAAM,CAAC,CAC/E,CAAC"}

package/dist/plan-builder.d.ts

@@ -1,93 +0,0 @@
-import { type ScaffoldPlan } from "./add-types.js";
-import type { DiscoveredArtifact, DiscoveredProfile } from "./project-discovery-types.js";
-import type { ScaffoldDependencyName } from "./scaffold-catalog.js";
-import type { PlannedArtifactInput } from "./plan-builder.types.js";
-import { PlanBuilderEffects } from "./plan-builder-effects.js";
-/** Per-request Effect owner with synchronous and Promise compatibility edges. */
-export declare class PlanBuilder extends PlanBuilderEffects {
-    /**
-     * Reads source through the Promise compatibility edge.
-     * @param path - Path inside the current project or owned resource.
-     * @returns Planned text when present, otherwise the current project file text.
-     */
-    read(path: string): Promise<string>;
-    /**
-     * Plans file creation through the Promise compatibility edge.
-     * @param path - Path inside the current project or owned resource.
-     * @param content - Complete bytes or text planned for the destination.
-     * @param mode - Optional restored or generated permission mode.
-     * @returns Completion after the existing contract has been applied.
-     */
-    create(path: string, content: string, mode?: number): Promise<void>;
-    /**
-     * Plans a source update through the Promise compatibility edge.
-     * @param path - Path inside the current project or owned resource.
-     * @param transform - Pure transformation applied atomically to the latest planned source.
-     * @returns Completion after the existing contract has been applied.
-     */
-    update(path: string, transform: (source: string) => string): Promise<void>;
-    /**
-     * Preserves the existing synchronous dependency API.
-     * @param name - Authored name or declaration key.
-     * @returns Completion after the existing contract has been applied.
-     */
-    dependency(name: ScaffoldDependencyName): void;
-    /**
-     * Preserves the existing synchronous artifact registration API.
-     * @param kind - Authoritative artifact kind.
-     * @param value - Artifact domain, source path, binding and optional identity/export form.
-     * @returns Completion after the artifact is registered in this request.
-     */
-    registerArtifact(kind: DiscoveredArtifact["kind"], value: PlannedArtifactInput): void;
-    /**
-     * Preserves the existing synchronous profile registration API.
-     * @param profile - Selected provider profile.
-     * @returns Completion after the existing contract has been applied.
-     */
-    registerProfile(profile: DiscoveredProfile): void;
-    /**
-     * Preserves the existing synchronous script API.
-     * @param name - Authored name or declaration key.
-     * @param command - Shell command stored under the package script name.
-     * @returns Completion after the existing contract has been applied.
-     */
-    script(name: string, command: string): void;
-    /**
-     * Preserves the existing synchronous warning API.
-     * @param code - Stable category code included in the resulting diagnostic.
-     * @param message - Existing user-facing diagnostic.
-     * @returns Completion after the existing contract has been applied.
-     */
-    warning(code: string, message: string): void;
-    /**
-     * Preserves the existing synchronous next-step API.
-     * @param command - Shell command shown as a follow-up instruction.
-     * @returns Completion after the existing contract has been applied.
-     */
-    nextStep(command: string): void;
-    /**
-     * Preserves the environment-example Promise API.
-     * @param name - Environment variable name.
-     * @param value - Example value used only for a new declaration.
-     * @returns Completion after the example declaration is planned.
-     */
-    envExample(name: string, value?: string): Promise<void>;
-    /**
-     * Preserves the gitignore Promise API.
-     * @param pattern - Declaration-owned glob or ignore pattern.
-     * @returns Completion after the existing contract has been applied.
-     */
-    gitignore(pattern: string): Promise<void>;
-    /**
-     * Preserves the immutable plan Promise API.
-     * @returns The frozen plan containing ordered operations, concrete dependencies and follow-up metadata.
-     */
-    finish(): Promise<ScaffoldPlan>;
-    /**
-     * Converts a source path into its existing project-relative representation.
-     * @param absolutePath - Absolute path converted relative to the discovered project root.
-     * @returns The path relative to the discovered project root using forward slashes.
-     */
-    relative(absolutePath: string): string;
-}
-//# sourceMappingURL=plan-builder.d.ts.map

package/dist/plan-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan-builder.d.ts","sourceRoot":"","sources":["../src/plan-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAIpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,iFAAiF;AACjF,qBAAa,WAAY,SAAQ,kBAAkB;IACjD;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInC;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI;IAI9C;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAIrF;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIjD;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3C;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI/B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAI/B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;CAGvC"}