@elytracms/core 0.0.6

package/dist/export-sync/index.js

@@ -0,0 +1,39 @@
+/**
+ * @elytracms/export-sync — the `builder` CLI surfaces around the canonical project model.
+ *
+ * EC-147 (vision AD-2): `builder push` discovers component manifests in the host repo,
+ * validates them, and syncs them up into builder registry persistence — with watch mode for
+ * local dev and an all-or-nothing CI mode. This is the day-to-day workflow: the embedded
+ * runtime renders the graph in the user's own app.
+ *
+ * EC-148 (vision AD-2/AD-4): `builder typegen` emits the per-collection delivery-shape +
+ * accessor types (EC-142/EC-143 codegen) into the host repo as a committed, deterministic
+ * module; `builder check` is the CI gate that verifies code and builder state agree —
+ * manifest drift both ways, graph↔code component coverage, type drift, and the canonical
+ * validation (route conflicts, broken bindings) surfaced through the CLI.
+ *
+ * EC-149 (vision AD-1): `builder eject` is the exit guarantee — a pure, deterministic
+ * generation (brief §4.9, EC-101–113) of a standalone Next.js App Router app with the model
+ * snapshotted in and the host repo's real components imported (never stubbed). The export-era
+ * `pull`/`validate` surface remains for validation and drift checks; `pull` is deprecated.
+ */
+export const PACKAGE = '@elytracms/core/export-sync';
+export * from './core';
+export * from './validate';
+export * from './generate';
+export * from './sync';
+export * from './eject';
+export * from './cli';
+export * from './fixtures';
+export * from './manifest-host';
+export * from './registry-sync-client';
+export * from './builder-source';
+export * from './push';
+export * from './watch';
+export * from './typegen';
+export * from './check';
+export * from './init';
+// EC-154: the workspace-config surface host repos use in `elytra.config.ts`.
+// Re-exported from `@elytracms/core/studio-core` so a host only needs the CLI package.
+export { defineElytraConfig, elytraConfigInputSchema, extractWorkspaceConfigExport, resolveWorkspaceConfig, toProjectSettings, WORKSPACE_CONFIG_FILE, WORKSPACE_CONFIG_FILES, } from '@elytracms/core/studio-core';
+//# sourceMappingURL=index.js.map

package/dist/export-sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/export-sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,6BAA6B,CAAA;AAEpD,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AACrB,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AAEtB,6EAA6E;AAC7E,uFAAuF;AACvF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,6BAA6B,CAAA"}

package/dist/export-sync/init.d.ts

@@ -0,0 +1,123 @@
+import type { CollectionDef } from '@elytracms/core/cms-core';
+import type { OperationsClient } from '@elytracms/core/operations';
+import type { ProjectSettings, WorkspaceConfigIssue } from '@elytracms/core/studio-core';
+import type { FileIO } from './sync';
+/**
+ * `builder init` — code-first workspace provisioning (EC-154, vision AD-8).
+ *
+ * Two modes:
+ *
+ * - `builder init` (no flags): scaffold a starter `elytra.config.ts` in the
+ *   host repo when none exists. Idempotent — an existing config is never
+ *   overwritten.
+ * - `builder init --project <slug>`: load + validate the host repo's
+ *   `elytra.config.ts` (same schema and structured issues as the studio),
+ *   find the entry, and provision the backend resources through the operations
+ *   layer. Project *identity & settings* are config-owned (EC-182, AD-11) — there
+ *   is no backend project record to create — so provisioning seeds the entry's
+ *   collection schema (`schema.save`) when it references a schema module. The
+ *   config-derived project id is the slug. Idempotent — a slug already provisioned
+ *   in this run is reported as already provisioned and left untouched.
+ *
+ * Like push/check, everything is injectable: a {@link WorkspaceConfigHost}
+ * abstracts config/module loading (the real one in `node.ts` uses dynamic
+ * `import()` like manifest discovery), and a {@link WorkspaceProvisioningClient}
+ * abstracts the backend (the direct adapter wraps an `OperationsClient` —
+ * in tests an in-memory one; a live deployment wires the same seam). No issue
+ * is ever a raw throw: failures are structured {@link InitIssue}s and a
+ * non-zero exit code.
+ */
+/** Loads the host repo's workspace config + referenced schema modules. */
+export interface WorkspaceConfigHost {
+    /**
+     * Locate and load the `elytra.config.*` module under `root`. Returns the
+     * raw module namespace (the default export carries the config), or
+     * `undefined` when no config file exists.
+     */
+    loadConfig(root: string): Promise<{
+        file: string;
+        moduleExports: unknown;
+    } | undefined>;
+    /**
+     * Load a collection-schema module referenced by a project entry
+     * (`schema: { module: './src/schema' }`), relative to `root`. Returns the
+     * raw module namespace; the collections are taken from its default export
+     * (or a named `collections` export) and validated here.
+     */
+    loadSchemaModule(root: string, modulePath: string): Promise<unknown>;
+}
+/** A backend provisioning failure, carried as data by the init flow. */
+export declare class WorkspaceProvisioningError extends Error {
+    constructor(message: string);
+}
+/**
+ * Transport between `init --project` and the builder backend: a direct in-process
+ * adapter exists now; an HTTP adapter can implement the same interface against
+ * builder endpoints later.
+ */
+export interface WorkspaceProvisioningClient {
+    readonly transport: 'direct' | 'http';
+    /** Find an existing project by slug (archived included), if any. */
+    findProjectBySlug(slug: string): Promise<{
+        id: string;
+        name: string;
+    } | undefined>;
+    /** Create the project with the config-derived settings; returns its id. */
+    createProject(input: {
+        name: string;
+        slug: string;
+        settings: ProjectSettings;
+    }): Promise<{
+        id: string;
+    }>;
+    /** Seed/replace the project's CMS collection schema. */
+    saveSchema(projectId: string, collections: readonly CollectionDef[]): Promise<void>;
+}
+/**
+ * The direct adapter: schema seeding goes through the operations layer
+ * (`schema.save`) so the CLI shares the exact validate → authorize → mutate →
+ * event pipeline the studio uses. Project identity is config-owned (EC-182, AD-11)
+ * — the slug *is* the project id, so there is no backend project record to create.
+ * Provisioning is tracked per process for idempotency. Operation failures are
+ * surfaced as {@link WorkspaceProvisioningError}s with the structured message intact.
+ */
+export declare function createDirectWorkspaceProvisioningClient(operations: OperationsClient): WorkspaceProvisioningClient;
+export type InitIssueCode = 'config-missing' | 'config-invalid' | 'unknown-project' | 'schema-load-error' | 'invalid-collections' | 'provision-failed' | 'not-configured';
+/** A structured init failure (CLI output is built from these). */
+export interface InitIssue {
+    code: InitIssueCode;
+    severity: 'error';
+    message: string;
+    /** Source file, when attributable (config file or schema module path). */
+    file?: string;
+    /** Underlying structured config issues, when `code` is 'config-invalid'. */
+    configIssues?: readonly WorkspaceConfigIssue[];
+}
+export type InitAction = 'scaffolded' | 'config-exists' | 'provisioned' | 'already-provisioned' | 'failed';
+export interface InitResult {
+    ok: boolean;
+    action: InitAction;
+    issues: InitIssue[];
+    /** The backend project id, when provisioning ran (or the project already existed). */
+    projectId?: string;
+    /** Collections seeded into the new project's schema, by id. */
+    seededCollections?: string[];
+}
+export interface InitOptions {
+    /** Host-repo root the config (and schema modules) are resolved against. */
+    root: string;
+    /** Slug of the configured project to provision; omitted = scaffold mode. */
+    project?: string;
+}
+export interface InitDeps {
+    host: WorkspaceConfigHost;
+    /** Required for `--project`; scaffold mode runs without a backend. */
+    client?: WorkspaceProvisioningClient;
+}
+/** Starter config written by `builder init` (kept minimal and self-documenting). */
+export declare const STARTER_WORKSPACE_CONFIG = "import { defineElytraConfig } from '@elytracms/core/export-sync'\n\n/**\n * Elytra workspace config (code-first, EC-154).\n *\n * Each entry declares one project. Shared fields can live in `base`; a field\n * set on a project replaces the base field entirely. Provision a project's\n * backend resources with: builder init --project <slug>\n */\nexport default defineElytraConfig({\n  projects: [\n    {\n      name: 'My Site',\n      slug: 'my-site',\n      locales: ['en'],\n      // schema: { module: './src/schema/collections' },\n      // components: { dir: './src/components' },\n      // convex: { deployment: 'https://<deployment>.convex.cloud' },\n    },\n  ],\n})\n";
+/**
+ * Run `builder init`. Returns a structured result and never throws.
+ * Scaffold mode and provisioning mode are both idempotent.
+ */
+export declare function runInit(deps: InitDeps, io: FileIO, options: InitOptions): Promise<InitResult>;

package/dist/export-sync/init.js

@@ -0,0 +1,234 @@
+import { z } from 'zod';
+import { collectionDefSchema } from '@elytracms/core/cms-core';
+import { WORKSPACE_CONFIG_FILE, extractWorkspaceConfigExport, resolveWorkspaceConfig, toProjectSettings, } from '@elytracms/core/studio-core';
+/** A backend provisioning failure, carried as data by the init flow. */
+export class WorkspaceProvisioningError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WorkspaceProvisioningError';
+    }
+}
+/**
+ * The direct adapter: schema seeding goes through the operations layer
+ * (`schema.save`) so the CLI shares the exact validate → authorize → mutate →
+ * event pipeline the studio uses. Project identity is config-owned (EC-182, AD-11)
+ * — the slug *is* the project id, so there is no backend project record to create.
+ * Provisioning is tracked per process for idempotency. Operation failures are
+ * surfaced as {@link WorkspaceProvisioningError}s with the structured message intact.
+ */
+export function createDirectWorkspaceProvisioningClient(operations) {
+    const provisioned = new Map();
+    return {
+        transport: 'direct',
+        async findProjectBySlug(slug) {
+            return provisioned.get(slug);
+        },
+        async createProject(input) {
+            // Config-owned identity: the slug is the canonical project id.
+            const record = { id: input.slug, name: input.name };
+            provisioned.set(input.slug, record);
+            return { id: record.id };
+        },
+        async saveSchema(projectId, collections) {
+            const result = await operations.schema.save({ projectId, collections: [...collections] });
+            if (!result.ok)
+                throw new WorkspaceProvisioningError(result.error.message);
+        },
+    };
+}
+// --- Scaffold -------------------------------------------------------------------
+/** Starter config written by `builder init` (kept minimal and self-documenting). */
+export const STARTER_WORKSPACE_CONFIG = `import { defineElytraConfig } from '@elytracms/core/export-sync'
+
+/**
+ * Elytra workspace config (code-first, EC-154).
+ *
+ * Each entry declares one project. Shared fields can live in \`base\`; a field
+ * set on a project replaces the base field entirely. Provision a project's
+ * backend resources with: builder init --project <slug>
+ */
+export default defineElytraConfig({
+  projects: [
+    {
+      name: 'My Site',
+      slug: 'my-site',
+      locales: ['en'],
+      // schema: { module: './src/schema/collections' },
+      // components: { dir: './src/components' },
+      // convex: { deployment: 'https://<deployment>.convex.cloud' },
+    },
+  ],
+})
+`;
+// --- Run --------------------------------------------------------------------------
+function fail(io, issues) {
+    for (const issue of issues) {
+        io.log(`  error [${issue.code}] ${issue.message}`);
+        for (const config of issue.configIssues ?? []) {
+            const at = config.path.length > 0 ? ` at ${formatPath(config.path)}` : '';
+            io.log(`    ${config.severity} [${config.code}]${at}: ${config.message}`);
+        }
+    }
+    return { ok: false, action: 'failed', issues };
+}
+function formatPath(path) {
+    return path.reduce((acc, part) => (typeof part === 'number' ? `${acc}[${part}]` : acc ? `${acc}.${part}` : part), '');
+}
+/** Accept the schema module's default export or a named `collections` export. */
+function extractCollectionsCandidate(moduleExports) {
+    if (typeof moduleExports === 'object' && moduleExports !== null) {
+        const record = moduleExports;
+        if (record.default !== undefined)
+            return record.default;
+        if (record.collections !== undefined)
+            return record.collections;
+    }
+    return moduleExports;
+}
+async function provisionProject(deps, io, options, entry, configFile) {
+    const client = deps.client;
+    if (!client) {
+        return fail(io, [
+            {
+                code: 'not-configured',
+                severity: 'error',
+                message: 'init --project is not configured (no provisioning client wired).',
+            },
+        ]);
+    }
+    // Load the referenced collection schema *before* creating anything, so a
+    // broken schema module never leaves a half-provisioned project behind.
+    let collections;
+    if (typeof entry.schema === 'object') {
+        const modulePath = entry.schema.module;
+        let moduleExports;
+        try {
+            moduleExports = await deps.host.loadSchemaModule(options.root, modulePath);
+        }
+        catch (cause) {
+            return fail(io, [
+                {
+                    code: 'schema-load-error',
+                    severity: 'error',
+                    message: `Could not load the schema module “${modulePath}”: ${cause instanceof Error ? cause.message : String(cause)}`,
+                    file: modulePath,
+                },
+            ]);
+        }
+        const parsed = z
+            .array(collectionDefSchema)
+            .safeParse(extractCollectionsCandidate(moduleExports));
+        if (!parsed.success) {
+            return fail(io, [
+                {
+                    code: 'invalid-collections',
+                    severity: 'error',
+                    message: `The schema module “${modulePath}” must export an array of collection definitions (default or named \`collections\` export): ${parsed.error.issues[0]?.message ?? 'invalid shape'}`,
+                    file: modulePath,
+                },
+            ]);
+        }
+        collections = parsed.data;
+    }
+    try {
+        const existing = await client.findProjectBySlug(entry.slug);
+        if (existing) {
+            io.log(`Project “${entry.slug}” is already provisioned (id ${existing.id}). Nothing to do — settings were not modified.`);
+            return { ok: true, action: 'already-provisioned', issues: [], projectId: existing.id };
+        }
+        const created = await client.createProject({
+            name: entry.name,
+            slug: entry.slug,
+            settings: toProjectSettings(entry),
+        });
+        io.log(`Created project “${entry.name}” (${entry.slug}) — id ${created.id}.`);
+        let seededCollections;
+        if (collections) {
+            await client.saveSchema(created.id, collections);
+            seededCollections = collections.map((c) => c.id);
+            io.log(`Seeded collection schema from ${typeof entry.schema === 'object' ? entry.schema.module : configFile}: ${seededCollections.join(', ') || '(empty)'}.`);
+        }
+        io.log(`Provisioned “${entry.slug}” from ${configFile}.`);
+        return {
+            ok: true,
+            action: 'provisioned',
+            issues: [],
+            projectId: created.id,
+            ...(seededCollections ? { seededCollections } : {}),
+        };
+    }
+    catch (cause) {
+        return fail(io, [
+            {
+                code: 'provision-failed',
+                severity: 'error',
+                message: cause instanceof Error ? cause.message : String(cause),
+            },
+        ]);
+    }
+}
+/**
+ * Run `builder init`. Returns a structured result and never throws.
+ * Scaffold mode and provisioning mode are both idempotent.
+ */
+export async function runInit(deps, io, options) {
+    const loaded = await deps.host.loadConfig(options.root);
+    // --- Scaffold mode: `builder init` ---------------------------------------
+    if (options.project === undefined) {
+        if (loaded) {
+            io.log(`Workspace config already exists at ${loaded.file}; nothing written.`);
+            return { ok: true, action: 'config-exists', issues: [] };
+        }
+        io.write(WORKSPACE_CONFIG_FILE, STARTER_WORKSPACE_CONFIG);
+        io.log(`Scaffolded ${WORKSPACE_CONFIG_FILE}. Edit it, then run: builder init --project <slug>`);
+        return { ok: true, action: 'scaffolded', issues: [] };
+    }
+    // --- Provision mode: `builder init --project <slug>` ----------------------
+    if (!loaded) {
+        return fail(io, [
+            {
+                code: 'config-missing',
+                severity: 'error',
+                message: `No ${WORKSPACE_CONFIG_FILE} found under “${options.root}”. Run \`builder init\` to scaffold one.`,
+            },
+        ]);
+    }
+    const extracted = extractWorkspaceConfigExport(loaded.moduleExports, loaded.file);
+    if ('issue' in extracted) {
+        return fail(io, [
+            {
+                code: 'config-invalid',
+                severity: 'error',
+                message: `${loaded.file} is not a valid workspace config.`,
+                file: loaded.file,
+                configIssues: [extracted.issue],
+            },
+        ]);
+    }
+    const resolved = resolveWorkspaceConfig(extracted.value, { file: loaded.file });
+    if (!resolved.ok) {
+        return fail(io, [
+            {
+                code: 'config-invalid',
+                severity: 'error',
+                message: `${loaded.file} is not a valid workspace config (${resolved.issues.length} issue(s)).`,
+                file: loaded.file,
+                configIssues: resolved.issues,
+            },
+        ]);
+    }
+    const entry = resolved.projects.find((project) => project.slug === options.project);
+    if (!entry) {
+        const known = resolved.projects.map((project) => project.slug).join(', ');
+        return fail(io, [
+            {
+                code: 'unknown-project',
+                severity: 'error',
+                message: `No project with slug “${options.project}” in ${loaded.file}. Configured slugs: ${known}.`,
+                file: loaded.file,
+            },
+        ]);
+    }
+    return provisionProject(deps, io, { ...options, project: options.project }, entry, loaded.file);
+}
+//# sourceMappingURL=init.js.map

package/dist/export-sync/init.js.map

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

package/dist/export-sync/manifest-host.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Manifest discovery contract for the code → builder push (EC-147, vision AD-2).
+ *
+ * ## Discovery convention
+ *
+ * A component manifest module is any file whose name ends in `.manifest.ts` /
+ * `.manifest.tsx` (or its compiled `.manifest.js` / `.manifest.mjs` form) anywhere
+ * under the scan root, excluding `node_modules`, dot-directories, and common build
+ * output directories. Every export of a manifest module must be a component manifest
+ * (created with `defineComponent`) or an array of manifests — nothing else. That keeps
+ * discovery deterministic: a stray export is a structured validation issue, never a
+ * silent skip.
+ *
+ * Why this convention: manifests today are declared inline with `defineComponent` in
+ * plain TS modules (see `@elytracms/core/starter-kits` `manifests.ts` and this package's
+ * `fixtures.ts`); a filename suffix keeps that authoring style, colocates a manifest
+ * next to its component (`hero.tsx` + `hero.manifest.ts`), mirrors the well-known
+ * `*.stories.tsx` / `*.test.ts` ecosystem pattern, and is cheap to glob, grep, and
+ * fs-watch.
+ *
+ * Discovery is injected behind {@link ManifestHost} so the push/watch logic is fully
+ * testable offline (fake hosts in tests, Node fs + dynamic import in the real bin).
+ * The real Node host lives in `@elytracms/core/export-sync/node` — kept out of the package
+ * root so the barrel stays browser-safe (the studio bundles this package via
+ * `@elytracms/core/plugins`).
+ */
+/** File suffixes that mark a module as a component manifest module. */
+export declare const MANIFEST_FILE_SUFFIXES: readonly [".manifest.ts", ".manifest.tsx", ".manifest.js", ".manifest.mjs"];
+/** Directories never scanned (or watched) for manifests. */
+export declare const MANIFEST_IGNORED_DIRECTORIES: ReadonlySet<string>;
+/** True when a path matches the manifest filename convention. */
+export declare function isManifestFile(path: string): boolean;
+/**
+ * How the push reaches manifest modules in a host repo. `listManifestFiles` returns
+ * root-relative POSIX paths (sorted, deterministic); `loadManifestCandidates` returns
+ * the module's exported manifest candidates — validation happens in the push, so a
+ * malformed export is a structured issue, never a crash.
+ */
+export interface ManifestHost {
+    listManifestFiles(root: string): Promise<string[]> | string[];
+    loadManifestCandidates(root: string, file: string): Promise<unknown[]> | unknown[];
+}
+/**
+ * Flatten a manifest module's exports into candidate manifest values. Arrays are
+ * flattened one level (e.g. `export const KIT_MANIFESTS = [...]`); duplicate references
+ * (e.g. a default export re-exporting a named one) are deduped.
+ */
+export declare function extractManifestCandidates(moduleExports: unknown): unknown[];

package/dist/export-sync/manifest-host.js

@@ -0,0 +1,73 @@
+/**
+ * Manifest discovery contract for the code → builder push (EC-147, vision AD-2).
+ *
+ * ## Discovery convention
+ *
+ * A component manifest module is any file whose name ends in `.manifest.ts` /
+ * `.manifest.tsx` (or its compiled `.manifest.js` / `.manifest.mjs` form) anywhere
+ * under the scan root, excluding `node_modules`, dot-directories, and common build
+ * output directories. Every export of a manifest module must be a component manifest
+ * (created with `defineComponent`) or an array of manifests — nothing else. That keeps
+ * discovery deterministic: a stray export is a structured validation issue, never a
+ * silent skip.
+ *
+ * Why this convention: manifests today are declared inline with `defineComponent` in
+ * plain TS modules (see `@elytracms/core/starter-kits` `manifests.ts` and this package's
+ * `fixtures.ts`); a filename suffix keeps that authoring style, colocates a manifest
+ * next to its component (`hero.tsx` + `hero.manifest.ts`), mirrors the well-known
+ * `*.stories.tsx` / `*.test.ts` ecosystem pattern, and is cheap to glob, grep, and
+ * fs-watch.
+ *
+ * Discovery is injected behind {@link ManifestHost} so the push/watch logic is fully
+ * testable offline (fake hosts in tests, Node fs + dynamic import in the real bin).
+ * The real Node host lives in `@elytracms/core/export-sync/node` — kept out of the package
+ * root so the barrel stays browser-safe (the studio bundles this package via
+ * `@elytracms/core/plugins`).
+ */
+/** File suffixes that mark a module as a component manifest module. */
+export const MANIFEST_FILE_SUFFIXES = [
+    '.manifest.ts',
+    '.manifest.tsx',
+    '.manifest.js',
+    '.manifest.mjs',
+];
+/** Directories never scanned (or watched) for manifests. */
+export const MANIFEST_IGNORED_DIRECTORIES = new Set([
+    'node_modules',
+    'dist',
+    'build',
+    'out',
+    'coverage',
+]);
+/** True when a path matches the manifest filename convention. */
+export function isManifestFile(path) {
+    return MANIFEST_FILE_SUFFIXES.some((suffix) => path.endsWith(suffix));
+}
+/**
+ * Flatten a manifest module's exports into candidate manifest values. Arrays are
+ * flattened one level (e.g. `export const KIT_MANIFESTS = [...]`); duplicate references
+ * (e.g. a default export re-exporting a named one) are deduped.
+ */
+export function extractManifestCandidates(moduleExports) {
+    if (typeof moduleExports !== 'object' || moduleExports === null)
+        return [];
+    const seen = new Set();
+    const candidates = [];
+    const push = (value) => {
+        if (seen.has(value))
+            return;
+        seen.add(value);
+        candidates.push(value);
+    };
+    for (const value of Object.values(moduleExports)) {
+        if (Array.isArray(value)) {
+            for (const item of value)
+                push(item);
+        }
+        else {
+            push(value);
+        }
+    }
+    return candidates;
+}
+//# sourceMappingURL=manifest-host.js.map

package/dist/export-sync/manifest-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-host.js","sourceRoot":"","sources":["../../src/export-sync/manifest-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,cAAc;IACd,eAAe;IACf,cAAc;IACd,eAAe;CACP,CAAA;AAEV,4DAA4D;AAC5D,MAAM,CAAC,MAAM,4BAA4B,GAAwB,IAAI,GAAG,CAAC;IACvE,cAAc;IACd,MAAM;IACN,OAAO;IACP,KAAK;IACL,UAAU;CACX,CAAC,CAAA;AAEF,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;AACvE,CAAC;AAaD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,aAAsB;IAC9D,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,EAAE,CAAA;IAC1E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAA;IAC/B,MAAM,UAAU,GAAc,EAAE,CAAA;IAChC,MAAM,IAAI,GAAG,CAAC,KAAc,EAAQ,EAAE;QACpC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAM;QAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACf,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC,CAAA;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACtC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,CAAA;QACb,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/export-sync/node.d.ts

@@ -0,0 +1,20 @@
+import type { WorkspaceConfigHost } from './init';
+import type { ManifestHost } from './manifest-host';
+import type { WatchDriver } from './watch';
+/**
+ * The real {@link ManifestHost}: recursive fs walk + dynamic `import()`. Loading a
+ * `.manifest.ts` module requires a TypeScript-capable runtime (the CLI is expected to
+ * run under `tsx` or Node type stripping in the host repo); compiled `.manifest.js` /
+ * `.manifest.mjs` modules load under plain Node.
+ */
+export declare function createNodeManifestHost(): ManifestHost;
+/**
+ * The real {@link WorkspaceConfigHost} (EC-154): probes the conventional
+ * `elytra.config.*` names under the host-repo root and loads modules with
+ * dynamic `import()`, exactly like manifest discovery. Loading the `.ts`
+ * variants requires a TypeScript-capable runtime (`tsx` / Node type stripping);
+ * compiled `.js`/`.mjs` configs load under plain Node.
+ */
+export declare function createNodeWorkspaceConfigHost(): WorkspaceConfigHost;
+/** The real watch driver: `node:fs` recursive watch (no external watcher dependency). */
+export declare function createFsWatchDriver(): WatchDriver;