@c9up/ream 0.2.25 → 0.2.27

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/prompts.d.ts.map

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

package/dist/console/prompts.js

@@ -11,6 +11,7 @@
 import { stdin, stdout } from 'node:process';
 import { clearLine, createInterface, cursorTo } from 'node:readline';
 import { ReamError } from '../errors/ReamError.js';
+import { runSelection } from './selection.js';
 import { colourise } from './ui.js';
 /**
  * Scripted answer builder — Console's `prompt.trap(name)`.
@@ -129,21 +130,11 @@ export class Prompt {
             await this.#validateSelection(picked, options, false);
             return this.#applyResult(picked[0], options);
         }
-        const limit = options.limit ?? 10;
-        for (;;) {
-            const typed = await this.readLine(this.#label(message, options, '(type to filter)'));
-            const matches = choices.filter((choice) => nameOf(choice).toLowerCase().includes(typed.toLowerCase()));
-            if (matches.length === 0) {
-                stdout.write(`${colourise('No match.', 'yellow')}\n`);
-                continue;
-            }
-            const first = matches[0];
-            if (matches.length === 1 && first !== undefined) {
-                return this.#finish(nameOf(first), options);
-            }
-            const picked = await this.#select(message, matches.slice(0, limit), { ...options, name: undefined }, false);
-            return picked[0];
-        }
+        // One list that narrows as you type, rather than a filter question
+        // followed by a list: upstream's autocomplete is a single prompt, and
+        // answering twice for one value is a different thing wearing its name.
+        const picked = await this.#select(message, choices, { ...options, name: undefined }, false, true, options.limit ?? 10);
+        return picked[0];
     }
     // ─── internals ──────────────────────────────────────────────
     async #text(message, options, masked) {
@@ -163,7 +154,7 @@ export class Prompt {
             return options.result ? options.result(value) : value;
         }
     }
-    async #select(message, choices, options, many) {
+    async #select(message, choices, options, many, filter, limit) {
         if (choices.length === 0) {
             throw new ReamError('E_CONSOLE_EMPTY_CHOICES', `"${message}" was asked with no options.`);
         }
@@ -175,39 +166,36 @@ export class Prompt {
             await this.#validateSelection(picked, options, many);
             return many ? picked : picked.map((value) => this.#applyResult(value, options));
         }
-        const defaultLabel = options.default === undefined
-            ? undefined
-            : [options.default]
-                .flat()
-                .map((index) => {
-                const choice = choices[index];
-                return choice === undefined ? String(index) : displayOf(choice);
-            })
-                .join(', ');
+        // Arrow keys, as upstream's prompts navigate. The list redraws in place
+        // until the user answers; a cancel is no answer, not an empty one.
         for (;;) {
-            stdout.write(`${this.#label(message, { ...options, default: defaultLabel }).trimEnd()}\n`);
-            choices.forEach((choice, index) => {
-                const hint = typeof choice === 'string' ? undefined : choice.hint;
-                stdout.write(`  ${colourise(String(index + 1), 'cyan')}) ${displayOf(choice)}` +
-                    `${hint === undefined ? '' : colourise(` — ${hint}`, 'dim')}\n`);
+            const outcome = await runSelection({
+                title: this.#label(message, { ...options, default: undefined }).trimEnd(),
+                items: choices.map((choice) => {
+                    const hint = typeof choice === 'string' ? undefined : choice.hint;
+                    return hint === undefined
+                        ? { label: displayOf(choice) }
+                        : { label: displayOf(choice), hint };
+                }),
+                many,
+                ...(options.default === undefined
+                    ? {}
+                    : {
+                        selected: [options.default]
+                            .flat()
+                            .filter((index) => Number.isInteger(index) && index >= 0 && index < choices.length),
+                    }),
+                ...(filter === true ? { filter: true } : {}),
+                ...(limit === undefined ? {} : { limit }),
             });
-            const answer = await this.readLine(many ? `Select (e.g. 1,3) from 1-${choices.length}: ` : `Select (1-${choices.length}): `);
-            // An empty answer takes the default — which for a selection prompt is an
-            // index, as Adonis spells it. Without this the default was shown in the
-            // label and then rejected as an invalid selection.
-            const indexes = answer === '' && options.default !== undefined
-                ? [options.default]
-                    .flat()
-                    .filter((index) => Number.isInteger(index) && index >= 0 && index < choices.length)
-                : answer
-                    .split(',')
-                    .map((part) => Number(part.trim()) - 1)
-                    .filter((index) => Number.isInteger(index) && index >= 0 && index < choices.length);
-            if (indexes.length === 0 || (!many && indexes.length !== 1)) {
-                stdout.write(`${colourise('Invalid selection.', 'yellow')}\n`);
-                continue;
+            if (outcome.kind === 'cancelled') {
+                throw new ReamError('E_CONSOLE_PROMPT_CANCELLED', `"${message}" was cancelled.`, {
+                    hint: 'Answer the prompt, or pass the value as a flag.',
+                });
             }
-            const picked = indexes.map((index) => nameOf(choices[index]));
+            // A multiple with nothing ticked is an answer of none, which is only
+            // valid if the command says so — `validate` is where that is decided.
+            const picked = outcome.indexes.map((index) => nameOf(choices[index]));
             const problem = await this.#selectionProblem(picked, options, many);
             if (problem !== undefined) {
                 stdout.write(`${colourise(problem, 'yellow')}\n`);