@hydranium/cli 1.0.0-next.10

package/lib/commands/init-workspace.js

@@ -0,0 +1,372 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+/**
+ * Workspace detection for `init --monorepo`.
+ *
+ * Split from `init.ts` because the rules here are the only part of `init` that
+ * reads files it does not write, and because the reliable/unreliable line runs
+ * straight through them: the root and the base tsconfig are *detected*, the
+ * package scope is *guessed from siblings* and the `private` flag is not
+ * derivable at all. Keeping them in one module makes that distinction reviewable
+ * rather than scattered across the scaffolder.
+ *
+ * Everything is expressed over {@link WorkspaceProbe} rather than `node:fs`, so
+ * the rules are testable against an in-memory tree instead of a temp directory.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/** True for a JSON object — the shape `package.json` and `tsconfig.json` parse to. */
+function isJsonObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Strip the two things `tsc` accepts in a config that `JSON.parse` rejects:
+ * comments, and a trailing comma before a closing brace or bracket.
+ *
+ * Written as a scanner rather than a regex because both constructs are legal
+ * INSIDE a string — `"https://example.com"` holds a `//`, and a description can
+ * end in a comma — so a pattern that ignores string state corrupts the very
+ * configs it is meant to rescue. Without this, a base config with a single
+ * comment reads as "no compilerOptions here" and the scaffold silently emits no
+ * `extends` at all, which is the worst failure shape available: quietly wrong
+ * rather than loudly broken.
+ */
+export function stripJsonComments(text) {
+    const characters = [...text];
+    const output = [];
+    const commaIndices = [];
+    let inString = false;
+    let escaped = false;
+    for (let index = 0; index < characters.length; index += 1) {
+        const character = characters[index];
+        const next = characters[index + 1];
+        if (inString) {
+            output.push(character);
+            if (escaped) {
+                escaped = false;
+            }
+            else if (character === '\\') {
+                escaped = true;
+            }
+            else if (character === '"') {
+                inString = false;
+            }
+            continue;
+        }
+        if (character === '"') {
+            inString = true;
+            output.push(character);
+            continue;
+        }
+        if (character === '/' && next === '/') {
+            while (index < characters.length && characters[index] !== '\n') {
+                index += 1;
+            }
+            output.push('\n');
+            continue;
+        }
+        if (character === '/' && next === '*') {
+            index += 2;
+            while (index < characters.length && !(characters[index] === '*' && characters[index + 1] === '/')) {
+                index += 1;
+            }
+            index += 1;
+            continue;
+        }
+        if (character === ',') {
+            commaIndices.push(output.length);
+        }
+        output.push(character);
+    }
+    // A comma is trailing only if the next thing that is not whitespace closes
+    // the object or array. Resolved after the scan, so the lookahead sees text
+    // with the comments already gone.
+    for (const commaIndex of commaIndices) {
+        let lookahead = commaIndex + 1;
+        while (lookahead < output.length && /\s/.test(output[lookahead])) {
+            lookahead += 1;
+        }
+        if (output[lookahead] === '}' || output[lookahead] === ']') {
+            output[commaIndex] = '';
+        }
+    }
+    return output.join('');
+}
+/**
+ * The real-filesystem probe.
+ *
+ * Every read is best-effort: detection runs over directories the user may not
+ * own, so an unreadable or malformed file degrades to "not found" rather than
+ * aborting a scaffold.
+ */
+export function createNodeWorkspaceProbe() {
+    const listEntries = (absolutePath, wantDirectory) => {
+        try {
+            return fs
+                .readdirSync(absolutePath, { withFileTypes: true })
+                .filter(entry => entry.isDirectory() === wantDirectory)
+                .map(entry => entry.name);
+        }
+        catch {
+            return [];
+        }
+    };
+    return {
+        readJson: absolutePath => {
+            try {
+                return JSON.parse(stripJsonComments(fs.readFileSync(absolutePath, 'utf-8')));
+            }
+            catch {
+                return undefined;
+            }
+        },
+        listDirectories: absolutePath => listEntries(absolutePath, true),
+        listFiles: absolutePath => listEntries(absolutePath, false),
+        readText: absolutePath => {
+            try {
+                return fs.readFileSync(absolutePath, 'utf-8');
+            }
+            catch {
+                return undefined;
+            }
+        }
+    };
+}
+/**
+ * The nearest ancestor of `targetDir` whose `package.json` declares
+ * `workspaces`.
+ *
+ * Nearest rather than outermost: nested workspaces are legal, and the inner one
+ * is the manifest that would actually claim the new package.
+ */
+export function findWorkspaceRoot(targetDir, probe) {
+    let current = path.resolve(targetDir);
+    for (;;) {
+        const manifest = probe.readJson(path.join(current, 'package.json'));
+        if (isJsonObject(manifest) && Array.isArray(manifest.workspaces)) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+    }
+}
+/** The `workspaces` globs of a detected root, as strings. */
+function readWorkspaces(rootDir, probe) {
+    const manifest = probe.readJson(path.join(rootDir, 'package.json'));
+    if (!isJsonObject(manifest) || !Array.isArray(manifest.workspaces)) {
+        return [];
+    }
+    return manifest.workspaces.filter((entry) => typeof entry === 'string');
+}
+/** Match one path segment against a glob segment, where `*` stands for "any run of non-separator". */
+function segmentMatches(glob, segment) {
+    const source = glob.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '[^/]*');
+    return new RegExp(`^${source}$`).test(segment);
+}
+/**
+ * True when a `workspaces` glob covers a repo-relative path.
+ *
+ * `**` is treated as covering any run of segments. Deliberately no glob
+ * dependency: npm's own set is small, and a wrong answer here only costs a
+ * printed hint that turns out to be unnecessary.
+ */
+export function workspaceGlobCovers(glob, relativePath) {
+    const globSegments = glob.split('/').filter(segment => segment.length > 0);
+    const pathSegments = relativePath.split('/').filter(segment => segment.length > 0);
+    const matches = (globIndex, pathIndex) => {
+        if (globIndex === globSegments.length) {
+            return pathIndex === pathSegments.length;
+        }
+        if (globSegments[globIndex] === '**') {
+            for (let skip = pathIndex; skip <= pathSegments.length; skip += 1) {
+                if (matches(globIndex + 1, skip)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        return (pathIndex < pathSegments.length &&
+            segmentMatches(globSegments[globIndex], pathSegments[pathIndex]) &&
+            matches(globIndex + 1, pathIndex + 1));
+    };
+    return matches(0, 0);
+}
+/**
+ * Expand a `workspaces` glob to the directories it currently names.
+ *
+ * `**` is not expanded — it returns nothing rather than walking an unbounded
+ * tree, because the only caller is scope inference, which a partial sample
+ * answers just as well.
+ */
+function expandWorkspaceGlob(rootDir, glob, probe) {
+    const segments = glob.split('/').filter(segment => segment.length > 0);
+    let directories = [rootDir];
+    for (const segment of segments) {
+        if (segment === '**') {
+            return [];
+        }
+        if (!segment.includes('*')) {
+            directories = directories.map(directory => path.join(directory, segment));
+            continue;
+        }
+        directories = directories.flatMap(directory => probe
+            .listDirectories(directory)
+            .filter(name => segmentMatches(segment, name))
+            .map(name => path.join(directory, name)));
+    }
+    return directories;
+}
+/**
+ * The npm scope the existing workspace members agree on.
+ *
+ * Guessed from siblings and NOT from the root manifest, which in a framework
+ * repo is routinely named for the repo rather than the scope it publishes under
+ * — so reading it would confidently produce the wrong answer. Requires a
+ * unanimous scope: a split verdict is exactly the case where a prompt should
+ * ask rather than a heuristic should pick.
+ */
+export function inferPackageScope(rootDir, workspaces, probe) {
+    const scopes = new Set();
+    for (const glob of workspaces) {
+        for (const directory of expandWorkspaceGlob(rootDir, glob, probe)) {
+            const manifest = probe.readJson(path.join(directory, 'package.json'));
+            if (!isJsonObject(manifest) || typeof manifest.name !== 'string') {
+                continue;
+            }
+            const scope = manifest.name.startsWith('@') ? manifest.name.split('/')[0] : '';
+            scopes.add(scope);
+        }
+    }
+    scopes.delete('');
+    return scopes.size === 1 ? [...scopes][0] : undefined;
+}
+/**
+ * The root tsconfig that actually carries `compilerOptions`.
+ *
+ * `tsconfig.json` at a monorepo root is very often a *solution* file — `files:
+ * []` plus `references` — so extending it inherits nothing and silently drops
+ * every compiler setting the package meant to pick up. Hence the search is by
+ * content, preferring the conventional `tsconfig.base.json` name only as a
+ * tie-break, never as the test.
+ */
+export function findBaseTsconfig(rootDir, probe) {
+    const present = probe.listFiles(rootDir).filter(name => /^tsconfig(\..+)?\.json$/.test(name));
+    const preferred = ['tsconfig.base.json', 'tsconfig.json'];
+    const candidates = [...preferred.filter(name => present.includes(name)), ...present.filter(name => !preferred.includes(name)).sort()];
+    for (const file of candidates) {
+        const parsed = probe.readJson(path.join(rootDir, file));
+        if (isJsonObject(parsed) && isJsonObject(parsed.compilerOptions) && Object.keys(parsed.compilerOptions).length > 0) {
+            return { file, compilerOptions: parsed.compilerOptions };
+        }
+    }
+    return undefined;
+}
+/**
+ * The repo's prettier `printWidth`, so the emitted sources wrap where the repo
+ * wraps instead of at the scaffold's own default.
+ *
+ * **Why this is worth detecting at all.** There is no width that is stable for
+ * an unknown repo — 80 (prettier's own default), 100, 120 and 140 each produce
+ * different wrapping — so emitted code that "passes a formatter check as-is" is
+ * only ever true relative to a config. Matching the one we can see is the
+ * closest thing available.
+ *
+ * **A regex over the file, deliberately, and only for the module forms.** The
+ * JSON forms are parsed properly; `.prettierrc.js` and `prettier.config.mjs` are
+ * executable modules that no scaffold should evaluate, and skipping them would
+ * miss the configs most repos actually use. The pattern takes the FIRST
+ * `printWidth`, which is the top-level one in every config laid out
+ * conventionally — an `overrides` entry appearing before it would win, and that
+ * is the known limit.
+ *
+ * Getting it wrong costs exactly what getting it absent costs today: the
+ * adopter's formatter rewraps on first commit. So a heuristic that is usually
+ * right strictly improves on no detection, and can break nothing.
+ */
+export function findPrettierPrintWidth(rootDir, probe) {
+    const manifest = probe.readJson(path.join(rootDir, 'package.json'));
+    if (isJsonObject(manifest) && isJsonObject(manifest.prettier) && typeof manifest.prettier.printWidth === 'number') {
+        return manifest.prettier.printWidth;
+    }
+    const present = probe.listFiles(rootDir);
+    for (const file of present.filter(name => name === '.prettierrc' || name === '.prettierrc.json')) {
+        const parsed = probe.readJson(path.join(rootDir, file));
+        if (isJsonObject(parsed) && typeof parsed.printWidth === 'number') {
+            return parsed.printWidth;
+        }
+    }
+    for (const file of present.filter(name => /^(\.prettierrc\.[cm]?[jt]s|prettier\.config\.[cm]?[jt]s)$/.test(name))) {
+        const width = /\bprintWidth\s*:\s*(\d+)/.exec(probe.readText(path.join(rootDir, file)) ?? '');
+        if (width) {
+            return Number(width[1]);
+        }
+    }
+    return undefined;
+}
+/**
+ * The root eslint config's filename, when the repo has one.
+ *
+ * Read to decide whether the scaffold emits a `lint` script. The failure it
+ * prevents is silent in the direction that matters: a task runner runs a script
+ * only where one is declared, so a package without `lint` is SKIPPED rather than
+ * reported, and the absence reads as a clean lint. Emitting the script into a
+ * repo whose lint invocation differs costs one visible line to edit.
+ *
+ * Both config generations, because detecting a repo that has not migrated off
+ * `.eslintrc` is free and the question asked here — does this repo lint? — is
+ * the same either way.
+ */
+export function findEslintConfig(rootDir, probe) {
+    return probe.listFiles(rootDir).find(name => /^eslint\.config\.[cm]?[jt]s$/.test(name) || /^\.eslintrc(\..+)?$/.test(name));
+}
+/** POSIX-style relative path, which is what both `extends` and `--prefix` want on every platform. */
+function posixRelative(from, to) {
+    return path.relative(from, to).split(path.sep).join('/');
+}
+/**
+ * Detect the workspace `targetDir` would join. `undefined` when no ancestor
+ * declares `workspaces`, which is the standalone case and not an error here —
+ * `runInit` decides whether that is fatal.
+ *
+ * The target is resolved against the process's working directory, so a relative
+ * one is relative to where the command was RUN, not to anything the scaffolder
+ * picks. That matters because the two are routinely different directories.
+ */
+export function detectWorkspace(targetDir, probe) {
+    const absoluteTarget = path.resolve(targetDir);
+    const rootDir = findWorkspaceRoot(absoluteTarget, probe);
+    if (rootDir === undefined) {
+        return undefined;
+    }
+    const workspaces = readWorkspaces(rootDir, probe);
+    const targetPath = posixRelative(rootDir, absoluteTarget);
+    // The target IS the workspace root — `init .` at the top of a monorepo, or a
+    // target that resolved to the cwd because it was empty. There is no member to
+    // place, so reporting a placement here describes a scaffold that cannot
+    // happen and names a directory the user never asked for.
+    if (targetPath === '') {
+        return undefined;
+    }
+    const base = findBaseTsconfig(rootDir, probe);
+    return {
+        rootDir,
+        workspaces,
+        targetPath,
+        coveredBy: workspaces.find(glob => workspaceGlobCovers(glob, targetPath)),
+        scope: inferPackageScope(rootDir, workspaces, probe),
+        baseTsconfig: base && posixRelative(absoluteTarget, path.join(rootDir, base.file)),
+        baseCompilerOptions: base?.compilerOptions,
+        printWidth: findPrettierPrintWidth(rootDir, probe),
+        eslintConfig: findEslintConfig(rootDir, probe)
+    };
+}
+//# sourceMappingURL=init-workspace.js.map

package/lib/commands/init-workspace.js.map

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

package/lib/commands/init.d.ts

@@ -0,0 +1,273 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { type JsonValue, type WorkspaceProbe } from './init-workspace.js';
+/**
+ * The protocol heads a scaffold can start, in composition order.
+ *
+ * `lsp` is mandatory rather than optional: it owns the workspace, the build
+ * pipeline and the shared service tier every other head reads through, so a
+ * project without it has nothing for `data` or `glsp` to serve.
+ */
+export declare const INIT_HEADS: readonly ["lsp", "data", "glsp"];
+/** One protocol head — see {@link INIT_HEADS}. */
+export type InitHead = (typeof INIT_HEADS)[number];
+/** The heads a scaffold emits when `--heads` is not given. */
+export declare const DEFAULT_INIT_HEADS: readonly InitHead[];
+/** True for a string naming one of {@link INIT_HEADS}. */
+export declare function isInitHead(value: string): value is InitHead;
+/**
+ * One grammar as the command line collected it, before any derivation.
+ *
+ * Everything but {@link name} is optional: the derivation rules produce a usable
+ * routing key and extension from the project and grammar names alone. An
+ * override is for the case derivation cannot reach — a file extension that is
+ * not the kebab grammar name.
+ */
+export interface InitGrammarSpec {
+    /** PascalCase grammar name — the `grammar X` declaration. */
+    readonly name: string;
+    /**
+     * File extensions, leading dot optional. Defaults to the kebab grammar id.
+     *
+     * A list rather than a single value because `langium-config.json`'s
+     * `fileExtensions` is a list: one language may answer for several suffixes.
+     */
+    readonly extensions?: readonly string[];
+    /** Override the derived routing key. */
+    readonly languageId?: string;
+    /**
+     * Scaffold a GLSP diagram for this grammar. Requires the `glsp` head.
+     *
+     * Per grammar rather than per project because
+     * `AbstractHydraniumGlspDiagramModule.declareLanguage()` returns ONE grammar's
+     * `LanguageMetaData` — a diagram type has exactly one grammar, and a grammar
+     * with no diagram sitting on the same server is the normal case.
+     */
+    readonly diagram?: boolean;
+}
+/**
+ * The resolved names of ONE grammar — the per-language tier.
+ *
+ * Everything here gains a sibling per additional grammar, which is what
+ * separates it from {@link InitComposition}'s project-level fields. The
+ * generated-symbol split is the reason the tiers cannot be collapsed:
+ * `langium-cli` emits `<grammar>GeneratedModule` and `<grammar>LanguageMetaData`
+ * per grammar, but `<projectName>AstReflection` and
+ * `<projectName>GeneratedSharedModule` once per project.
+ */
+export interface InitGrammarNames {
+    /** PascalCase grammar name — the `grammar X` declaration. */
+    readonly grammar: string;
+    /** Kebab grammar id — names the `.langium` file. */
+    readonly grammarId: string;
+    /**
+     * Kebab routing key — the `langium-config.json` entry id.
+     *
+     * Qualified as `<projectId>-<grammarId>` whenever the grammar is separately
+     * named or the project holds more than one, because a second grammar needs a
+     * second id and retro-fitting the suffix later renames a routing key every
+     * host has already bound.
+     */
+    readonly languageId: string;
+    /** File extensions without leading dots. At least one. */
+    readonly extensions: readonly string[];
+    /**
+     * The grammar's entry rule, always `<Grammar>Model`.
+     *
+     * **Derived rather than fixed, because one `langium-cli` run over N grammars
+     * emits ONE combined `ast.ts` sharing one reflection.** Two grammars both
+     * declaring `entry Model:` would put the same interface name in that module
+     * twice.
+     */
+    readonly entryRule: string;
+    /**
+     * The starter node rule, always `<Grammar>Node`.
+     *
+     * **`Node` and not `Element`:** the transfer-model generator emits
+     * `export interface <projectName>Element` as the base type every rule
+     * extends, so a rule named `<Grammar>Element` would collide with it in the
+     * single-grammar case — the same interface declared twice, the second
+     * extending itself.
+     */
+    readonly nodeRule: string;
+    /** Whether a GLSP diagram is scaffolded for this grammar. */
+    readonly diagram: boolean;
+}
+/**
+ * Where a scaffold sits inside an existing npm workspace.
+ *
+ * Detected rather than asked, because both members are things a wrong answer
+ * makes actively broken rather than merely unidiomatic: a `--prefix` that names
+ * the wrong directory runs the wrong package's scripts, and an `extends` that
+ * points at a *solution* tsconfig (`files: []` plus `references`, which is what
+ * a monorepo root usually has) inherits no compiler options at all.
+ */
+export interface InitWorkspacePlacement {
+    /** POSIX path of the target relative to the workspace root, e.g. `packages/foo`. */
+    readonly targetPath: string;
+    /** Relative specifier of the tsconfig carrying `compilerOptions`, e.g. `../../tsconfig.base.json`. */
+    readonly baseTsconfig?: string;
+    /** That tsconfig's `compilerOptions`, so the emitted one can omit what it would inherit unchanged. */
+    readonly baseCompilerOptions?: Readonly<Record<string, JsonValue>>;
+    /** The workspace's prettier `printWidth`, so emitted sources wrap where the repo wraps. */
+    readonly printWidth?: number;
+    /** Filename of the workspace's eslint config; its presence is what makes the scaffold emit a `lint` script. */
+    readonly eslintConfig?: string;
+}
+/**
+ * How the emitted `package.json` presents itself.
+ *
+ * Separate from {@link InitWorkspacePlacement} because the two answer to
+ * different authorities: the placement is *detected* from the surrounding tree,
+ * while the scope and the publishability are **intent** and are never inferred —
+ * a repo's root manifest is routinely named for the repo rather than for the
+ * scope it publishes under, so guessing would confidently produce the wrong
+ * package name. The wizard offers a sibling-derived default; the flags decide.
+ *
+ * This is the one place the two polarities meet: every option surface upstream
+ * carries `public`, because a flag names a DEVIATION from the default, while
+ * this type carries `private`, because that is the manifest key the template
+ * substitutes.
+ */
+export interface InitPackaging {
+    /** npm scope for the package name, e.g. `@acme`. Absent leaves it unscoped. */
+    readonly scope?: string;
+    /** Emit `"private": true` — a package npm refuses to publish. */
+    readonly private: boolean;
+    /** The workspace the package joins. Absent for a standalone project. */
+    readonly workspace?: InitWorkspacePlacement;
+}
+/**
+ * A standalone, unscoped, unpublishable package — what `init` emits without the
+ * packaging flags.
+ *
+ * `private` defaults to TRUE because the manifest also declares `license:
+ * "UNLICENSED"`, and a package that grants no rights while being publishable to
+ * a public registry asserts two contradictory things about itself. npm pairs
+ * those two keys for exactly this reason. The scaffold cannot pick a licence for
+ * a stranger's project, so it withholds publication instead of granting rights
+ * nobody chose; `--public` is the opt-out for a project that has picked one.
+ */
+export declare const STANDALONE_PACKAGING: InitPackaging;
+/**
+ * The full scaffold description: one project tier, N grammar tiers. Templates
+ * read this and are rendered per tier.
+ */
+export interface InitComposition {
+    /** PascalCase project name — the Langium `projectName`. */
+    readonly name: string;
+    /**
+     * Kebab project id, always derived from {@link name} and never from a
+     * language id. Names what a second grammar must not rename: the package and
+     * `bin` key, the DI module file, and the data-server port command (there is
+     * one data server per project, not one per language).
+     */
+    readonly projectId: string;
+    /** The protocol heads to start, always including `lsp`. */
+    readonly heads: readonly InitHead[];
+    /** The grammars, in the order given. The first is the configuration root. */
+    readonly grammars: readonly InitGrammarNames[];
+    /** How the emitted `package.json` presents itself, and where it sits. */
+    readonly packaging: InitPackaging;
+    /**
+     * The framework version every emitted `@hydranium/*` pin is derived from —
+     * the scaffolding CLI's own, since the scope is versioned as one line.
+     *
+     * Carried on the composition rather than read where the templates render, so
+     * {@link planInitFiles} stays pure over its input. That is what lets a golden
+     * pin the emitted shape at a fixed token without pinning the number, which
+     * would otherwise turn every release into a red suite.
+     */
+    readonly frameworkVersion: string;
+}
+/** One file the scaffold writes: relative path + fully-substituted content. */
+export interface InitFile {
+    path: string;
+    content: string;
+}
+/** Options for the {@link runInit} subcommand. */
+export interface InitCommandOptions {
+    /** Target directory to scaffold into. */
+    readonly targetDir: string;
+    /** PascalCase project name (drives the services + shared generated module names). */
+    readonly name: string;
+    /**
+     * The grammars to scaffold, in order. Defaults to a single grammar named
+     * after the project, which is the single-language starter shape.
+     */
+    readonly grammars?: readonly InitGrammarSpec[];
+    /** The protocol heads to start. Defaults to {@link DEFAULT_INIT_HEADS}. */
+    readonly heads?: readonly InitHead[];
+    /** Scaffold into a non-empty directory anyway. */
+    readonly force?: boolean;
+    /**
+     * Scaffold a member of the surrounding npm workspace: extend its base
+     * tsconfig, leave `.gitignore` to the root, and address the package by
+     * `--prefix` in the scripts it prints back at itself. Errors when no ancestor
+     * declares `workspaces`, rather than silently degrading to a standalone
+     * project the caller did not ask for.
+     */
+    readonly monorepo?: boolean;
+    /** npm scope for the package name, e.g. `@acme`. */
+    readonly scope?: string;
+    /** Omit `"private": true`, leaving the package publishable. */
+    readonly public?: boolean;
+    /** Output sink. Default: `process.stdout.write`. Tests inject a capturing stub. */
+    readonly write?: (line: string) => void;
+    /** Filesystem port for workspace detection. Default: the real filesystem. */
+    readonly probe?: WorkspaceProbe;
+    /** Test-only: capture the planned files instead of writing to disk. */
+    readonly __writeFilesForTest?: (targetDir: string, files: readonly InitFile[]) => void;
+}
+/** Kebab-case a PascalCase/camelCase name. */
+export declare function kebab(name: string): string;
+/**
+ * Derive the whole scaffold description from `--name` plus the collected
+ * grammars. Throws on a name that is not a valid PascalCase identifier — both
+ * project and grammar names become prefixes of generated TypeScript symbols.
+ *
+ * With no grammars given, one is synthesised from the project name, which is
+ * the single-language starter shape.
+ */
+export declare function resolveInitComposition(name: string, grammars?: readonly InitGrammarSpec[], heads?: readonly InitHead[], packaging?: InitPackaging): InitComposition;
+/**
+ * Plan the files a scaffold emits — every template rendered for this
+ * composition. Pure over its input → unit-testable without touching disk;
+ * {@link runInit} is the thin IO wrapper.
+ */
+export declare function planInitFiles(composition: InitComposition): InitFile[];
+/** True when `dir` exists and contains at least one entry. */
+export declare function isNonEmptyDir(dir: string): boolean;
+/** The packaging flags, plus the workspace they were given in. */
+export interface InitPackagingOptions {
+    readonly monorepo?: boolean;
+    readonly scope?: string;
+    readonly public?: boolean;
+    readonly probe?: WorkspaceProbe;
+}
+/**
+ * Resolve the packaging tier for a target directory, running workspace
+ * detection when `--monorepo` asked for it.
+ *
+ * Exported because the `init`-provenance gate re-runs the reference example's
+ * recorded invocation and must reach the same composition `runInit` would: a
+ * second copy of these rules there would drift from these, and the gate exists
+ * precisely to catch drift.
+ */
+export declare function resolveInitPackaging(targetDir: string, options: InitPackagingOptions): InitPackaging;
+/**
+ * Scaffold a new Hydranium language project end-to-end: one starter grammar per
+ * `--grammar`, `create<Name>Services` DI wiring, a launcher for each head in
+ * `--heads`, `langium-config.json`, `package.json`, and scripts. Does NOT run `npm install`
+ * or `langium generate` — those are printed as next steps, so the command stays
+ * offline and side-effect-free beyond the files it writes. Refuses a non-empty
+ * target directory unless `force`.
+ */
+export declare function runInit(options: InitCommandOptions): void;
+//# sourceMappingURL=init.d.ts.map

package/lib/commands/init.d.ts.map

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