@c9up/ream 0.2.25 → 0.2.26

package/dist/console/make/generators.d.ts

@@ -0,0 +1,36 @@
+/**
+ * What each `make:` command generates.
+ *
+ * One table rather than ten near-identical commands: every generator is a
+ * name, a stub and the variables that stub reads. The differences that matter
+ * — which suffix a class carries, whether the name is snake_cased for the file
+ * — live here, in one place, instead of being spread across ten files that
+ * drift.
+ *
+ * The DESTINATION is not here. It is in the stub's own front matter, so an
+ * application that publishes `stubs/make/controller.stub` can move the file as
+ * well as change its contents.
+ */
+import type { StubState } from '../../stubs/template.js';
+/** Extra input a generator takes beyond the name. */
+export interface GeneratorInput {
+    /** `app/<module>/…` — where a module-scoped file lands. */
+    module?: string;
+    /** `make:middleware --stack server|router|named`. */
+    stack?: string;
+    /** `make:listener --event OrderShipped`. */
+    event?: string;
+}
+export interface Generator {
+    /** The stub, under `stubs/make/`. */
+    kind: string;
+    commandName: string;
+    description: string;
+    /** Does it take `--module`? */
+    moduleScoped: boolean;
+    /** The variables its stub reads. */
+    state(name: string, input: GeneratorInput): StubState;
+}
+export declare const GENERATORS: readonly Generator[];
+export declare function generatorFor(kind: string): Generator | undefined;
+//# sourceMappingURL=generators.d.ts.map

package/dist/console/make/generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../../src/console/make/generators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAGxD,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,YAAY,EAAE,OAAO,CAAA;IACrB,oCAAoC;IACpC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,SAAS,CAAA;CACtD;AAOD,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EAgI1C,CAAA;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEhE"}

package/dist/console/make/generators.js

@@ -0,0 +1,148 @@
+/**
+ * What each `make:` command generates.
+ *
+ * One table rather than ten near-identical commands: every generator is a
+ * name, a stub and the variables that stub reads. The differences that matter
+ * — which suffix a class carries, whether the name is snake_cased for the file
+ * — live here, in one place, instead of being spread across ten files that
+ * drift.
+ *
+ * The DESTINATION is not here. It is in the stub's own front matter, so an
+ * application that publishes `stubs/make/controller.stub` can move the file as
+ * well as change its contents.
+ */
+import { ensureSuffix, stripSuffixInsensitive, toPascalCase, toSnakeCase } from './naming.js';
+/** The shared trio every stub may read. */
+function base(name, className, module) {
+    return { className, module, name };
+}
+export const GENERATORS = [
+    {
+        kind: 'controller',
+        commandName: 'make:controller',
+        description: 'Generate an HTTP controller',
+        moduleScoped: true,
+        state: (name, input) => base(name, ensureSuffix(name, 'Controller'), input.module ?? 'controllers'),
+    },
+    {
+        kind: 'service',
+        commandName: 'make:service',
+        description: 'Generate a service class',
+        moduleScoped: true,
+        state: (name, input) => base(name, ensureSuffix(name, 'Service'), input.module ?? 'services'),
+    },
+    {
+        kind: 'entity',
+        commandName: 'make:entity',
+        description: 'Generate an Atlas entity',
+        moduleScoped: true,
+        state: (name, input) => ({
+            // No suffix: an entity is `User`, not `UserEntity`.
+            ...base(name, toPascalCase(name), input.module ?? 'entities'),
+            tableName: `${toSnakeCase(name)}s`,
+        }),
+    },
+    {
+        kind: 'validator',
+        commandName: 'make:validator',
+        description: 'Generate a Rune validator',
+        moduleScoped: true,
+        state: (name, input) => base(name, ensureSuffix(name, 'Validator'), input.module ?? 'validators'),
+    },
+    {
+        kind: 'provider',
+        commandName: 'make:provider',
+        description: 'Generate a service provider',
+        moduleScoped: false,
+        state: (name) => base(name, ensureSuffix(name, 'Provider'), ''),
+    },
+    {
+        kind: 'command',
+        commandName: 'make:command',
+        description: 'Generate a console command',
+        moduleScoped: false,
+        state: (name) => {
+            // `app:provision` is the command NAME; the class and the file come from
+            // its last segment, or the published stub would generate a command
+            // unreachable under the name it was asked for.
+            const segments = name.split(':');
+            const last = segments[segments.length - 1] ?? name;
+            return {
+                className: toPascalCase(toSnakeCase(last)),
+                fileName: toSnakeCase(last),
+                name,
+            };
+        },
+    },
+    {
+        kind: 'middleware',
+        commandName: 'make:middleware',
+        description: 'Generate an HTTP middleware',
+        moduleScoped: false,
+        state: (name, input) => {
+            const fileName = toSnakeCase(stripSuffixInsensitive(name, 'middleware'));
+            const stack = input.stack ?? 'router';
+            const importer = `() => import('#middleware/${fileName}_middleware.js')`;
+            // The line the user pastes into their kernel — different per stack, and
+            // wrong in a way that is hard to spot if it is guessed.
+            const registration = stack === 'server'
+                ? `server.use([${importer}])`
+                : stack === 'named'
+                    ? `router.named({ ${fileName}: ${importer} })`
+                    : `router.use([${importer}])`;
+            return {
+                className: `${toPascalCase(fileName)}Middleware`,
+                fileName,
+                name,
+                registration,
+                stack,
+            };
+        },
+    },
+    {
+        kind: 'event',
+        commandName: 'make:event',
+        description: 'Generate an event class',
+        moduleScoped: false,
+        state: (name) => {
+            const fileName = toSnakeCase(name);
+            return { className: toPascalCase(fileName), fileName, name };
+        },
+    },
+    {
+        kind: 'listener',
+        commandName: 'make:listener',
+        description: 'Generate an event listener',
+        moduleScoped: false,
+        state: (name, input) => {
+            const fileName = toSnakeCase(name);
+            const className = toPascalCase(fileName);
+            if (input.event === undefined) {
+                // Without `--event` there is nothing to type the handler with, and
+                // inventing an import would point at a file that does not exist.
+                return {
+                    className,
+                    fileName,
+                    name,
+                    importLine: '',
+                    eventType: 'unknown',
+                    registration: `emitter.on(SomeEvent, ${className})`,
+                };
+            }
+            const eventFile = toSnakeCase(input.event);
+            const eventClass = toPascalCase(eventFile);
+            return {
+                className,
+                fileName,
+                name,
+                importLine: `import type ${eventClass} from '#app/events/${eventFile}.js'\n\n`,
+                eventType: eventClass,
+                registration: `emitter.on(${eventClass}, ${className})`,
+            };
+        },
+    },
+];
+export function generatorFor(kind) {
+    return GENERATORS.find((generator) => generator.kind === kind);
+}
+//# sourceMappingURL=generators.js.map

package/dist/console/make/generators.js.map

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

package/dist/console/make/naming.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The naming conventions the generators follow.
+ *
+ * Ported from the Rust generator they replace, case for case: a rename here
+ * changes what `make:controller user` produces, so the rules are written out
+ * rather than approximated.
+ */
+/** Add the suffix unless the name already carries it. */
+export declare function ensureSuffix(name: string, suffix: string): string;
+/** `user_profile` / `user-profile` / `user profile` → `UserProfile`. */
+export declare function toPascalCase(name: string): string;
+/**
+ * `UserProfile` → `user_profile`, `HTTPServer` → `http_server`.
+ *
+ * The acronym case is why this is not a one-line regex: an underscore goes
+ * before a capital that FOLLOWS a lowercase, or that follows a capital and is
+ * followed by a lowercase — which is where `HTTPServer` splits.
+ */
+export declare function toSnakeCase(name: string): string;
+/** Drop a trailing `Middleware` / `middleware` / `_middleware`, whatever the case. */
+export declare function stripSuffixInsensitive(name: string, suffix: string): string;
+/** Longer than this is not a name, it is a paste accident. */
+export declare const MAX_NAME_LENGTH = 128;
+/**
+ * Is this a name a generator may build a path from?
+ *
+ * Refused rather than sanitised: a name with a separator in it is either a
+ * mistake or an attempt to write outside the project, and quietly rewriting it
+ * would produce a file somewhere the user did not ask for.
+ */
+export declare function nameProblem(name: string): string | undefined;
+//# sourceMappingURL=naming.d.ts.map

package/dist/console/make/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../src/console/make/naming.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwBhD;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAO3E;AAED,8DAA8D;AAC9D,eAAO,MAAM,eAAe,MAAM,CAAA;AAElC;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS5D"}

package/dist/console/make/naming.js

@@ -0,0 +1,82 @@
+/**
+ * The naming conventions the generators follow.
+ *
+ * Ported from the Rust generator they replace, case for case: a rename here
+ * changes what `make:controller user` produces, so the rules are written out
+ * rather than approximated.
+ */
+/** Add the suffix unless the name already carries it. */
+export function ensureSuffix(name, suffix) {
+    return name.endsWith(suffix) ? name : `${name}${suffix}`;
+}
+/** `user_profile` / `user-profile` / `user profile` → `UserProfile`. */
+export function toPascalCase(name) {
+    return name
+        .split(/[_\-\s]/)
+        .filter((part) => part !== '')
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+/**
+ * `UserProfile` → `user_profile`, `HTTPServer` → `http_server`.
+ *
+ * The acronym case is why this is not a one-line regex: an underscore goes
+ * before a capital that FOLLOWS a lowercase, or that follows a capital and is
+ * followed by a lowercase — which is where `HTTPServer` splits.
+ */
+export function toSnakeCase(name) {
+    const chars = [...name];
+    let out = '';
+    for (const [index, char] of chars.entries()) {
+        if (char.toUpperCase() === char && char.toLowerCase() !== char) {
+            const previous = chars[index - 1];
+            const next = chars[index + 1];
+            const previousLower = previous !== undefined &&
+                previous === previous.toLowerCase() &&
+                previous !== previous.toUpperCase();
+            const nextLower = next !== undefined && next === next.toLowerCase() && next !== next.toUpperCase();
+            const previousUpper = previous !== undefined &&
+                previous === previous.toUpperCase() &&
+                previous !== previous.toLowerCase();
+            if (index > 0 && (previousLower || (nextLower && previousUpper)))
+                out += '_';
+            out += char.toLowerCase();
+            continue;
+        }
+        out += char;
+    }
+    return out;
+}
+/** Drop a trailing `Middleware` / `middleware` / `_middleware`, whatever the case. */
+export function stripSuffixInsensitive(name, suffix) {
+    const lower = name.toLowerCase();
+    const suffixLower = suffix.toLowerCase();
+    if (lower.length > suffixLower.length && lower.endsWith(suffixLower)) {
+        return name.slice(0, name.length - suffix.length).replace(/[_-]+$/, '');
+    }
+    return name;
+}
+/** Longer than this is not a name, it is a paste accident. */
+export const MAX_NAME_LENGTH = 128;
+/**
+ * Is this a name a generator may build a path from?
+ *
+ * Refused rather than sanitised: a name with a separator in it is either a
+ * mistake or an attempt to write outside the project, and quietly rewriting it
+ * would produce a file somewhere the user did not ask for.
+ */
+export function nameProblem(name) {
+    if (name.trim() === '')
+        return 'the name is empty';
+    if (name.length > MAX_NAME_LENGTH)
+        return `the name is longer than ${MAX_NAME_LENGTH} characters`;
+    if (/[/\\]/.test(name))
+        return 'a name may not contain a path separator';
+    if (name.includes('..'))
+        return 'a name may not contain ".."';
+    if (!/^[A-Za-z][A-Za-z0-9_\-:]*$/.test(name)) {
+        return 'a name starts with a letter and holds letters, digits, "_", "-" or ":"';
+    }
+    return undefined;
+}
+//# sourceMappingURL=naming.js.map

package/dist/console/make/naming.js.map

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

package/dist/console/make/resolve.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Finding a stub, rendering it, and knowing where it goes.
+ *
+ * A stub is addressed the way `codemods.makeUsingStub` addresses one — a
+ * package's `stubsRoot` plus a path inside it, `make/controller.stub` — so a
+ * generator and a package's `configure()` hook read the same file through the
+ * same rule. The application's own copy under `stubs/` wins over the shipped
+ * one, which is what `ream eject` is for.
+ */
+import { type StubState } from '../../stubs/template.js';
+/** Where an application keeps its own copies — Adonis' `stubs/` root. */
+export declare const PUBLISHED_ROOT = "stubs";
+/** The stubs this package ships. */
+export declare const REAM_STUBS_ROOT: string;
+export interface RenderedStub {
+    /** Relative to the project root, as the stub's front matter declares it. */
+    path: string;
+    contents: string;
+    /** Did the application's own copy win? */
+    published: boolean;
+}
+/**
+ * A stub path that could escape its root never reaches the filesystem.
+ *
+ * `eject` takes one from the command line, so this is the boundary: no
+ * absolute path, no `..`, and a `.stub` file at the end of it.
+ */
+export declare function isSafeStubPath(stubPath: string): boolean;
+/** Where the application's copy of `stubPath` would live. */
+export declare function publishedPath(stubPath: string, cwd: string): string | undefined;
+/** Read `stubPath` — the application's copy when there is one. */
+export declare function readStub(stubsRoot: string, stubPath: string, cwd: string): {
+    source: string;
+    published: boolean;
+};
+/** Split `---\nto: …\n---\n<body>`; the front matter names the destination. */
+export declare function splitFrontMatter(template: string): {
+    to?: string;
+    body: string;
+};
+export declare function renderStub(stubsRoot: string, stubPath: string, state: StubState, cwd: string, fallbackPath?: string): RenderedStub;
+/** `make/controller.stub` — the stub a generator of that kind reads. */
+export declare function stubPathFor(kind: string): string;
+/** Render one of this package's own generator stubs. */
+export declare function renderStubFor(kind: string, state: StubState, cwd: string): RenderedStub;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/console/make/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/console/make/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEhE,yEAAyE;AACzE,eAAO,MAAM,cAAc,UAAU,CAAA;AAErC,oCAAoC;AACpC,eAAO,MAAM,eAAe,QAA4D,CAAA;AAExF,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMxD;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/E;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAaxC;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmBhF;AAkBD,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GACpB,YAAY,CAWd;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAEvF"}

package/dist/console/make/resolve.js

@@ -0,0 +1,113 @@
+/**
+ * Finding a stub, rendering it, and knowing where it goes.
+ *
+ * A stub is addressed the way `codemods.makeUsingStub` addresses one — a
+ * package's `stubsRoot` plus a path inside it, `make/controller.stub` — so a
+ * generator and a package's `configure()` hook read the same file through the
+ * same rule. The application's own copy under `stubs/` wins over the shipped
+ * one, which is what `ream eject` is for.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { render } from '../../stubs/template.js';
+/** Where an application keeps its own copies — Adonis' `stubs/` root. */
+export const PUBLISHED_ROOT = 'stubs';
+/** The stubs this package ships. */
+export const REAM_STUBS_ROOT = path.join(import.meta.dirname, '..', '..', '..', 'stubs');
+/**
+ * A stub path that could escape its root never reaches the filesystem.
+ *
+ * `eject` takes one from the command line, so this is the boundary: no
+ * absolute path, no `..`, and a `.stub` file at the end of it.
+ */
+export function isSafeStubPath(stubPath) {
+    if (stubPath === '' || stubPath.length > 256)
+        return false;
+    if (path.isAbsolute(stubPath))
+        return false;
+    const segments = stubPath.split(/[/\\]/);
+    if (segments.includes('..') || segments.includes(''))
+        return false;
+    return segments.every((segment) => /^[\w.-]+$/.test(segment));
+}
+/** Where the application's copy of `stubPath` would live. */
+export function publishedPath(stubPath, cwd) {
+    if (!isSafeStubPath(stubPath))
+        return undefined;
+    return path.join(cwd, PUBLISHED_ROOT, stubPath);
+}
+/** Read `stubPath` — the application's copy when there is one. */
+export function readStub(stubsRoot, stubPath, cwd) {
+    const published = publishedPath(stubPath, cwd);
+    if (published !== undefined && fs.existsSync(published)) {
+        return { source: fs.readFileSync(published, 'utf8'), published: true };
+    }
+    if (!isSafeStubPath(stubPath)) {
+        throw new Error(`[make] unusable stub path: ${stubPath}`);
+    }
+    const shipped = path.join(stubsRoot, stubPath);
+    if (!fs.existsSync(shipped)) {
+        throw new Error(`[make] no stub at "${stubPath}" (looked in ${stubsRoot})`);
+    }
+    return { source: fs.readFileSync(shipped, 'utf8'), published: false };
+}
+/** Split `---\nto: …\n---\n<body>`; the front matter names the destination. */
+export function splitFrontMatter(template) {
+    const trimmed = template.replace(/^[\r\n]+/, '');
+    if (!trimmed.startsWith('---'))
+        return { body: template };
+    const after = trimmed.slice(3).replace(/^\r?\n/, '');
+    const end = after.indexOf('\n---');
+    if (end === -1) {
+        throw new Error('[make] a stub opened its front matter with `---` and never closed it');
+    }
+    const block = after.slice(0, end);
+    const body = after.slice(end + 4).replace(/^\r?\n/, '');
+    let to;
+    for (const rawLine of block.split('\n')) {
+        const line = rawLine.trim();
+        if (line === '' || line.startsWith('#'))
+            continue;
+        const at = line.indexOf(':');
+        if (at === -1)
+            throw new Error(`[make] unreadable stub front-matter line: \`${line}\``);
+        if (line.slice(0, at).trim() === 'to')
+            to = line.slice(at + 1).trim();
+    }
+    return to === undefined ? { body } : { to, body };
+}
+/**
+ * The destination a stub declares, checked.
+ *
+ * Absolute paths and `..` are refused rather than normalised: a published stub
+ * is a file in the project, and a generator is not a way to write outside it.
+ */
+function assertInsideProject(destination) {
+    if (destination === '')
+        throw new Error('[make] the stub declares an empty destination');
+    if (path.isAbsolute(destination)) {
+        throw new Error(`[make] a stub may not write to an absolute path: ${destination}`);
+    }
+    if (destination.split(/[/\\]/).includes('..')) {
+        throw new Error(`[make] a stub may not write outside the project: ${destination}`);
+    }
+}
+export function renderStub(stubsRoot, stubPath, state, cwd, fallbackPath) {
+    const { source, published } = readStub(stubsRoot, stubPath, cwd);
+    const { to, body } = splitFrontMatter(source);
+    const destination = to === undefined ? fallbackPath : render(to, state);
+    if (destination === undefined) {
+        throw new Error(`[make] the stub at "${stubPath}" declares no destination — add a \`to:\` front-matter line.`);
+    }
+    assertInsideProject(destination);
+    return { path: destination, contents: render(body, state), published };
+}
+/** `make/controller.stub` — the stub a generator of that kind reads. */
+export function stubPathFor(kind) {
+    return `make/${kind}.stub`;
+}
+/** Render one of this package's own generator stubs. */
+export function renderStubFor(kind, state, cwd) {
+    return renderStub(REAM_STUBS_ROOT, stubPathFor(kind), state, cwd);
+}
+//# sourceMappingURL=resolve.js.map

package/dist/console/make/resolve.js.map

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

package/dist/console/ui.d.ts

@@ -1,20 +1,14 @@
 /**
- * Console UI — `this.logger` and `this.prompt` on every command (Console parity).
+ * The one colour helper the Kernel's help and the prompts use.
  *
- * Kept dependency-free: the framework ships no colour or prompt library, and
- * pulling one in for the CLI surface alone is not worth the install weight.
+ * It is a thin call into `@c9up/lumen` rather than a second palette: two
+ * tables of escape codes in one package is how `[ warn ]` ends up yellow in
+ * one command and plain in another.
+ *
+ * The environment is read on EVERY call, not cached, because a command can be
+ * run in-process with the environment changed around it — which is exactly
+ * what the tests covering `FORCE_COLOR` do.
  */
-declare const CODES: {
-    readonly reset: "\u001B[0m";
-    readonly dim: "\u001B[2m";
-    readonly red: "\u001B[31m";
-    readonly green: "\u001B[32m";
-    readonly yellow: "\u001B[33m";
-    readonly blue: "\u001B[34m";
-    readonly magenta: "\u001B[35m";
-    readonly cyan: "\u001B[36m";
-};
-export type Colour = keyof Omit<typeof CODES, 'reset'>;
+export type Colour = 'dim' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan';
 export declare function colourise(text: string, colour: Colour, stream?: NodeJS.WriteStream): string;
-export {};
 //# sourceMappingURL=ui.d.ts.map

package/dist/console/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/console/ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,QAAA,MAAM,KAAK;;;;;;;;;CASD,CAAA;AAEV,MAAM,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,KAAK,EAAE,OAAO,CAAC,CAAA;AAEtD,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,WAAoB,GAClC,MAAM,CAGR"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/console/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;AAErF,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,WAAoB,GAClC,MAAM,CAGR"}

package/dist/console/ui.js

@@ -1,31 +1,18 @@
 /**
- * Console UI — `this.logger` and `this.prompt` on every command (Console parity).
+ * The one colour helper the Kernel's help and the prompts use.
  *
- * Kept dependency-free: the framework ships no colour or prompt library, and
- * pulling one in for the CLI surface alone is not worth the install weight.
+ * It is a thin call into `@c9up/lumen` rather than a second palette: two
+ * tables of escape codes in one package is how `[ warn ]` ends up yellow in
+ * one command and plain in another.
+ *
+ * The environment is read on EVERY call, not cached, because a command can be
+ * run in-process with the environment changed around it — which is exactly
+ * what the tests covering `FORCE_COLOR` do.
  */
 import { stdout } from 'node:process';
-/** Colour is opt-out via NO_COLOR and skipped when piped to a file. */
-function supportsColour(stream) {
-    if (process.env.NO_COLOR !== undefined && process.env.NO_COLOR !== '')
-        return false;
-    if (process.env.FORCE_COLOR !== undefined && process.env.FORCE_COLOR !== '')
-        return true;
-    return Boolean(stream.isTTY);
-}
-const CODES = {
-    reset: '\u001B[0m',
-    dim: '\u001B[2m',
-    red: '\u001B[31m',
-    green: '\u001B[32m',
-    yellow: '\u001B[33m',
-    blue: '\u001B[34m',
-    magenta: '\u001B[35m',
-    cyan: '\u001B[36m',
-};
+import { ansiColors, silentColors, supportsColor } from '@c9up/lumen';
 export function colourise(text, colour, stream = stdout) {
-    if (!supportsColour(stream))
-        return text;
-    return `${CODES[colour]}${text}${CODES.reset}`;
+    const colors = supportsColor(stream) ? ansiColors() : silentColors();
+    return colors[colour](text);
 }
 //# sourceMappingURL=ui.js.map

package/dist/console/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/console/ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,uEAAuE;AACvE,SAAS,cAAc,CAAC,MAA0B;IAChD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,KAAK,CAAA;IACnF,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IACxF,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,KAAK,GAAG;IACZ,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,YAAY;IACrB,IAAI,EAAE,YAAY;CACV,CAAA;AAIV,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,MAAc,EACd,SAA6B,MAAM;IAEnC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAA;IACxC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;AAChD,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/console/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,UAAU,EAAe,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAIlF,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,MAAc,EACd,SAA6B,MAAM;IAEnC,MAAM,MAAM,GAAW,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAA;IAC5E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAA;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -95,8 +95,8 @@ export { errors } from './errors/aggregate.js';
 export type { AppContext, ConfigReader, ProviderContract } from './Provider.js';
 export { Provider } from './Provider.js';
 export type { AuthenticatorName, Authenticators, ContainerBinding, ContainerBindings, } from './types/index.js';
-export type { Codemods } from './Codemods.js';
-export { createCodemods } from './Codemods.js';
+export { type Codemods, createCodemods, type GeneratedStub, type StubState, } from './Codemods.js';
+export { compile as compileStub, escapeHtml, generate as generateStub, render as renderStub, type StubBlock, StubSyntaxError, type StubValue, type TemplateOptions, } from './stubs/template.js';
 export type { ErrorEmitter, ErrorEvent, ErrorSeverity } from './ErrorBoundary.js';
 export { ErrorBoundary } from './ErrorBoundary.js';
 export { didYouMean, findClosestMatches, levenshtein } from './errors/FuzzyMatcher.js';
@@ -121,5 +121,5 @@ export { BaseEvent, Emitter, type EmitterResolver, type ListenerClass, } from '.
 export { type BufferedEvent, type BufferedEventName, type EventFinder, EventsBuffer, } from './events/EventsBuffer.js';
 export type { ErrorReporter, LockBackend, LockBackendFactory, LockRedisClient, LockRedisResolver, RunTaskOutcome, ScheduleEvent, ScheduleEventSink, ScheduleInvocation, ScheduleMetadata, ScheduleProviderOptions, SchedulerConfig, SchedulerOptions, ScheduleTaskCompletedEvent, ScheduleTaskFailedEvent, ScheduleTaskSkippedEvent, ScheduleTaskStartedEvent, TaskInfo, TaskStats, } from './scheduler/index.js';
 export { defineSchedulerConfig, getScheduleMetadata, locks, MemoryLockBackend, RedisLockBackend, SCHEDULE_METADATA_KEY, Schedule, ScheduleProvider, Scheduler, StatsTracker, } from './scheduler/index.js';
-export declare const VERSION = "0.2.25";
+export declare const VERSION = "0.2.26";
 //# sourceMappingURL=index.d.ts.map