ormbridge 0.0.0-stage → 0.2.0

package/dist/formats.js

@@ -0,0 +1,212 @@
+import { emitDjango } from './emitters/django.js';
+import { emitDoctrine, isValidPhpNamespace } from './emitters/doctrine.js';
+import { emitGraphene } from './emitters/graphene.js';
+import { emitLaravel } from './emitters/laravel.js';
+import { emitPrisma, } from './emitters/prisma.js';
+import { emitTypeorm } from './emitters/typeorm.js';
+import { emitTypescriptInterfaces } from './emitters/typescriptInterfaces.js';
+import { parseDoctrine } from './parsers/doctrine.js';
+import { parseDjango } from './parsers/django.js';
+import { parseLaravel } from './parsers/laravel.js';
+import { parsePrisma } from './parsers/prisma.js';
+import { parseTypeorm } from './parsers/typeorm.js';
+import { err, ok } from './result.js';
+import { expandManyToMany, normalizeSchema, } from './transforms.js';
+export const DEFAULT_APP_LABEL = 'app';
+const adapters = new Map();
+/** Adds an adapter to the registry. Fails when the name or an extension is already taken. */
+export function registerFormat(adapter) {
+    if (adapter.name.trim() === '') {
+        return err('INVALID_OPTION', 'A format adapter must have a non-empty name.');
+    }
+    if (adapters.has(adapter.name)) {
+        return err('INVALID_OPTION', `The format "${adapter.name}" is already registered.`);
+    }
+    for (const extension of adapter.extensions) {
+        const owner = getFormatByExtension(extension);
+        if (owner !== undefined) {
+            return err('INVALID_OPTION', `The extension "${extension}" cannot be used by the format "${adapter.name}" because it is already used by "${owner.name}".`);
+        }
+    }
+    adapters.set(adapter.name, adapter);
+    return ok(adapter);
+}
+/** Removes an adapter from the registry. Returns false when the name was not registered. */
+export function unregisterFormat(name) {
+    return adapters.delete(name);
+}
+/** Looks up a format by name. Returns a descriptive error that lists the valid names. */
+export function getFormat(name) {
+    const adapter = adapters.get(name);
+    if (adapter === undefined) {
+        return err('UNSUPPORTED_CONVERSION', `Unknown format "${name}". Expected one of: ${listFormatNames().join(', ')}.`);
+    }
+    return ok(adapter);
+}
+/** Returns the adapter that owns a file extension (for example ".py"), or undefined. */
+export function getFormatByExtension(extension) {
+    for (const adapter of adapters.values()) {
+        if (adapter.extensions.includes(extension)) {
+            return adapter;
+        }
+    }
+    return undefined;
+}
+/** Returns every registered adapter in registration order. */
+export function listFormats() {
+    return [...adapters.values()];
+}
+/** Returns every registered format name in registration order. */
+export function listFormatNames() {
+    return [...adapters.keys()];
+}
+/** Builds the text printed by the `formats` command: one line per registered format. */
+export function describeFormats(adapters) {
+    const nameWidth = Math.max(...adapters.map((adapter) => adapter.name.length));
+    const lines = adapters.map((adapter) => {
+        const abilities = [];
+        if (adapter.parse !== undefined) {
+            abilities.push('read');
+        }
+        if (adapter.emit !== undefined) {
+            abilities.push('write');
+        }
+        return (`${adapter.name.padEnd(nameWidth)}  ` +
+            `extensions: ${adapter.extensions.join(', ') || '(none)'}  ` +
+            `${abilities.join(' + ') || 'no read/write support'}  ` +
+            adapter.description);
+    });
+    return `${lines.join('\n')}\n`;
+}
+const djangoAdapter = {
+    name: 'django',
+    extensions: ['.py'],
+    description: 'Django models (models.py or a models/ package)',
+    parse: (sources, options) => {
+        const djangoSources = sources.map((source) => ({
+            path: source.path,
+            text: source.text,
+            appLabel: options.appLabel ?? source.appLabel ?? DEFAULT_APP_LABEL,
+        }));
+        return parseDjango(djangoSources, { autoField: options.autoField });
+    },
+    emit: (schema) => ok(emitDjango(schema)),
+};
+const prismaAdapter = {
+    name: 'prisma',
+    extensions: ['.prisma'],
+    description: 'Prisma schema (schema.prisma)',
+    parse: (sources, options) => {
+        const prismaSources = sources.map((source) => ({
+            path: source.path,
+            text: source.text,
+        }));
+        return Promise.resolve(parsePrisma(prismaSources, {
+            appLabel: options.appLabel ?? DEFAULT_APP_LABEL,
+        }));
+    },
+    emit: (schema, options) => {
+        const prepared = options.naming === 'normalize'
+            ? normalizeSchema(schema)
+            : expandManyToMany(schema);
+        return ok(emitPrisma(prepared, {
+            provider: options.provider,
+            header: options.header,
+            camelFields: options.naming === 'normalize',
+            ...(options.prismaVersion === undefined
+                ? {}
+                : { prismaVersion: options.prismaVersion }),
+        }));
+    },
+};
+const typeormAdapter = {
+    name: 'typeorm',
+    // No extension is claimed: ".ts" is too generic to infer, so pass --from/--to typeorm.
+    extensions: [],
+    description: 'TypeORM entity classes (TypeScript)',
+    parse: (sources, options) => parseTypeorm(sources.map((source) => ({
+        path: source.path,
+        text: source.text,
+    })), { appLabel: options.appLabel ?? DEFAULT_APP_LABEL }),
+    emit: (schema, options) => {
+        const prepared = options.naming === 'normalize' ? normalizeSchema(schema) : schema;
+        return ok(emitTypeorm(prepared, {
+            provider: options.provider,
+            camelFields: options.naming === 'normalize',
+        }));
+    },
+};
+const grapheneAdapter = {
+    name: 'graphene',
+    // No extension is claimed: ".py" belongs to Django, so pass --to graphene.
+    extensions: [],
+    description: 'Graphene (graphene-django) GraphQL schema',
+    emit: (schema) => ok(emitGraphene(schema)),
+};
+const typescriptAdapter = {
+    name: 'typescript',
+    // Output only, and no extension is claimed: TypeORM already reads TypeScript, so pass --to typescript.
+    extensions: [],
+    description: 'Plain TypeScript interfaces and enums',
+    emit: (schema, options) => {
+        const prepared = options.naming === 'normalize' ? normalizeSchema(schema) : schema;
+        return ok(emitTypescriptInterfaces(prepared, {
+            camelFields: options.naming === 'normalize',
+        }));
+    },
+};
+const doctrineAdapter = {
+    name: 'doctrine',
+    // No extension is claimed: ".php" is too generic to infer, so pass --from/--to doctrine.
+    extensions: [],
+    description: 'Doctrine ORM entities (PHP 8 attributes)',
+    parse: (sources, options) => parseDoctrine(sources.map((source) => ({
+        path: source.path,
+        text: source.text,
+    })), { appLabel: options.appLabel ?? DEFAULT_APP_LABEL }),
+    emit: (schema, options) => {
+        const namespace = options.namespace?.replace(/^\\+|\\+$/g, '');
+        if (namespace !== undefined && !isValidPhpNamespace(namespace)) {
+            return err('INVALID_OPTION', `Invalid namespace "${options.namespace ?? ''}". Expected a PHP namespace such as App\\Entity.`);
+        }
+        const prepared = options.naming === 'normalize' ? normalizeSchema(schema) : schema;
+        return ok(emitDoctrine(prepared, {
+            provider: options.provider,
+            camelFields: options.naming === 'normalize',
+            ...(namespace === undefined ? {} : { namespace }),
+        }));
+    },
+};
+const laravelAdapter = {
+    name: 'laravel',
+    // No extension is claimed: ".php" is too generic to infer, so pass --from/--to laravel.
+    extensions: [],
+    description: 'Laravel migrations and Eloquent models',
+    parse: (sources, options) => parseLaravel(sources.map((source) => ({
+        path: source.path,
+        text: source.text,
+    })), { appLabel: options.appLabel ?? DEFAULT_APP_LABEL }),
+    emit: (schema, options) => {
+        const namespace = options.namespace?.replace(/^\\+|\\+$/g, '');
+        if (namespace !== undefined && !isValidPhpNamespace(namespace)) {
+            return err('INVALID_OPTION', `Invalid namespace "${options.namespace ?? ''}". Expected a PHP namespace such as App\\Models.`);
+        }
+        return ok(emitLaravel(schema, {
+            provider: options.provider,
+            naming: options.naming,
+            ...(namespace === undefined ? {} : { namespace }),
+        }));
+    },
+};
+// The built-in names and extensions are distinct, so these registrations cannot fail.
+const builtIns = [
+    registerFormat(djangoAdapter),
+    registerFormat(prismaAdapter),
+    registerFormat(typeormAdapter),
+    registerFormat(doctrineAdapter),
+    registerFormat(laravelAdapter),
+    registerFormat(grapheneAdapter),
+    registerFormat(typescriptAdapter),
+];
+export const BUILT_IN_FORMAT_NAMES = builtIns.flatMap((registered) => registered.ok ? [registered.value.name] : []);
+//# sourceMappingURL=formats.js.map

package/dist/formats.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+export { convertText, DEFAULT_APP_LABEL, FORMAT_NAMES } from './convert.js';
+export type { ConvertOptions, ConvertResult, FormatName, SourceText, } from './convert.js';
+export { describeFormats, getFormat, getFormatByExtension, listFormatNames, listFormats, registerFormat, unregisterFormat, } from './formats.js';
+export type { FormatAdapter, FormatEmitOutput, FormatOptions, MultiFileEmitOutput, } from './formats.js';
+export { runConversion, deriveAppLabel } from './io.js';
+export type { RunOptions, RunSummary } from './io.js';
+export { parseDjango } from './parsers/django.js';
+export type { DjangoSourceFile, DjangoParseOptions } from './parsers/django.js';
+export { parsePrisma } from './parsers/prisma.js';
+export type { PrismaSourceFile, PrismaParseOptions } from './parsers/prisma.js';
+export { parseDoctrine } from './parsers/doctrine.js';
+export type { DoctrineSourceFile, DoctrineParseOptions, } from './parsers/doctrine.js';
+export { parseLaravel } from './parsers/laravel.js';
+export type { LaravelSourceFile, LaravelParseOptions, } from './parsers/laravel.js';
+export { parseTypeorm } from './parsers/typeorm.js';
+export type { TypeormSourceFile, TypeormParseOptions, } from './parsers/typeorm.js';
+export { emitPrisma, PRISMA_PROVIDERS } from './emitters/prisma.js';
+export type { EmitOutput, PrismaEmitOptions, PrismaProvider, } from './emitters/prisma.js';
+export { emitDjango } from './emitters/django.js';
+export { emitDoctrine } from './emitters/doctrine.js';
+export type { DoctrineEmitOptions } from './emitters/doctrine.js';
+export { emitLaravel } from './emitters/laravel.js';
+export type { LaravelEmitOptions } from './emitters/laravel.js';
+export { emitGraphene } from './emitters/graphene.js';
+export { emitTypeorm } from './emitters/typeorm.js';
+export type { TypeormEmitOptions } from './emitters/typeorm.js';
+export { emitTypescriptInterfaces } from './emitters/typescriptInterfaces.js';
+export type { TypescriptDateMode, TypescriptInterfacesOptions, } from './emitters/typescriptInterfaces.js';
+export { expandManyToMany, normalizeSchema } from './transforms.js';
+export type { NamingMode } from './transforms.js';
+export type * from './ir.js';
+export { err, ok } from './result.js';
+export type { ConversionError, ErrorCode, Result } from './result.js';

package/dist/index.js

@@ -0,0 +1,18 @@
+export { convertText, DEFAULT_APP_LABEL, FORMAT_NAMES } from './convert.js';
+export { describeFormats, getFormat, getFormatByExtension, listFormatNames, listFormats, registerFormat, unregisterFormat, } from './formats.js';
+export { runConversion, deriveAppLabel } from './io.js';
+export { parseDjango } from './parsers/django.js';
+export { parsePrisma } from './parsers/prisma.js';
+export { parseDoctrine } from './parsers/doctrine.js';
+export { parseLaravel } from './parsers/laravel.js';
+export { parseTypeorm } from './parsers/typeorm.js';
+export { emitPrisma, PRISMA_PROVIDERS } from './emitters/prisma.js';
+export { emitDjango } from './emitters/django.js';
+export { emitDoctrine } from './emitters/doctrine.js';
+export { emitLaravel } from './emitters/laravel.js';
+export { emitGraphene } from './emitters/graphene.js';
+export { emitTypeorm } from './emitters/typeorm.js';
+export { emitTypescriptInterfaces } from './emitters/typescriptInterfaces.js';
+export { expandManyToMany, normalizeSchema } from './transforms.js';
+export { err, ok } from './result.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAO5E,OAAO,EACL,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAKtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKpD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAMpE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAK9E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,48 @@
+import { type ConvertOptions, type ConvertResult } from './convert.js';
+import { type Result } from './result.js';
+export interface RunOptions extends ConvertOptions {
+    /** Files or directories to read. */
+    inputs: string[];
+    /**
+     * Destination. A file path for single-text formats; a directory for formats
+     * that yield several files. When omitted the converted text is only returned.
+     */
+    output?: string;
+    /** Run the whole conversion and report what would be written, without touching the filesystem. */
+    dryRun?: boolean;
+    /** Compare the result with the existing output and report differences, without writing. */
+    check?: boolean;
+}
+/** How a planned output file relates to what is on disk. */
+export type OutputState = 'created' | 'changed' | 'unchanged';
+/** One file the conversion produces, with its relation to the existing file. */
+export interface PlannedFile {
+    /** Absolute destination path. */
+    path: string;
+    text: string;
+    bytes: number;
+    lines: number;
+    state: OutputState;
+    /** Short description of the differences for a changed file, such as "+3 -1 lines (first difference at line 12)". */
+    diff?: string;
+}
+export interface RunSummary extends ConvertResult {
+    inputFiles: string[];
+    /** The output path as written: the file for single-text formats, the directory for multi-file formats. */
+    outputPath?: string;
+    /** Every file planned for the output path. Empty when no output path was given. */
+    plannedFiles: PlannedFile[];
+    /** True when files were written (never in dry-run or check mode). */
+    written: boolean;
+}
+/** Reads the inputs, converts them, and writes the result to the output path when one is given. */
+export declare function runConversion(options: RunOptions): Promise<Result<RunSummary>>;
+/** Counts lines the way an editor does: a trailing newline does not add a line. */
+export declare function countLines(text: string): number;
+/**
+ * Describes how two texts differ in a short line, for example
+ * "+3 -1 lines (first difference at line 12)".
+ */
+export declare function summarizeDiff(before: string, after: string): string;
+/** Derives a Django app label from the location of a models.py file or models/ package. */
+export declare function deriveAppLabel(filePath: string): string;

package/dist/io.js

@@ -0,0 +1,328 @@
+import { mkdir, readdir, readFile, stat, writeFile } from 'node:fs/promises';
+import { basename, dirname, extname, isAbsolute, join, resolve, } from 'node:path';
+import { convertText, } from './convert.js';
+import { describeThrown, err, ok } from './result.js';
+/** Directories skipped only when reading PHP projects: Composer packages and Symfony's cache/log directory. */
+const PHP_SKIPPED_DIRECTORIES = new Set(['vendor', 'var']);
+/**
+ * Directories skipped when reading a Laravel project. The Django list does not
+ * apply: `migrations` is where Laravel keeps its schema, and `build` / `env` /
+ * `dist` are ordinary names there.
+ */
+const LARAVEL_SKIPPED_DIRECTORIES = new Set([
+    'vendor',
+    'storage',
+    'node_modules',
+    'tests',
+    '.git',
+]);
+const SKIPPED_DIRECTORIES = new Set([
+    'node_modules',
+    'venv',
+    '.venv',
+    'env',
+    '.git',
+    '__pycache__',
+    'migrations',
+    'site-packages',
+    'dist',
+    'build',
+]);
+/** Reads the inputs, converts them, and writes the result to the output path when one is given. */
+export async function runConversion(options) {
+    const discovered = await discoverInputFiles(options.inputs, options.from);
+    if (!discovered.ok) {
+        return discovered;
+    }
+    const sources = [];
+    for (const filePath of discovered.value) {
+        const read = await readTextFile(filePath);
+        if (!read.ok) {
+            return read;
+        }
+        sources.push({
+            path: filePath,
+            text: read.value,
+            appLabel: deriveAppLabel(filePath),
+        });
+    }
+    const converted = await convertText(sources, options);
+    if (!converted.ok) {
+        return converted;
+    }
+    const summary = {
+        ...converted.value,
+        inputFiles: discovered.value,
+        plannedFiles: [],
+        written: false,
+    };
+    if (options.output === undefined) {
+        if (converted.value.files !== undefined) {
+            return err('INVALID_OPTION', `The "${options.to}" format produces ${Object.keys(converted.value.files).length} files, so it needs an output directory. Pass -o <directory>.`);
+        }
+        return ok(summary);
+    }
+    const planned = await planOutput(resolve(options.output), converted.value, options.to);
+    if (!planned.ok) {
+        return planned;
+    }
+    const outputPath = resolve(options.output);
+    const withPlan = {
+        ...summary,
+        outputPath,
+        plannedFiles: planned.value,
+    };
+    if (options.dryRun === true || options.check === true) {
+        return ok(withPlan);
+    }
+    for (const file of planned.value) {
+        if (file.state === 'unchanged') {
+            continue;
+        }
+        const written = await writeTextFile(file.path, file.text);
+        if (!written.ok) {
+            return written;
+        }
+    }
+    return ok({ ...withPlan, written: true });
+}
+/** Works out the destination files and compares each with what is already on disk. */
+async function planOutput(outputPath, converted, format) {
+    const existing = await classifyPath(outputPath);
+    const entries = [];
+    if (converted.files === undefined) {
+        if (existing === 'directory') {
+            return err('INVALID_OPTION', `The output path "${outputPath}" is a directory, but the "${format}" format produces a single file. Pass a file path to -o.`);
+        }
+        entries.push([outputPath, converted.output]);
+    }
+    else {
+        const names = Object.keys(converted.files).sort();
+        if (existing === 'file' ||
+            (existing === 'missing' && extname(outputPath) !== '')) {
+            return err('INVALID_OPTION', `The "${format}" format produces ${names.length} files (${names.join(', ')}), so -o must be a directory, but "${outputPath}" is a file path. Pass a directory such as "${join(dirname(outputPath), basename(outputPath, extname(outputPath)))}".`);
+        }
+        for (const name of names) {
+            const target = resolveInside(outputPath, name);
+            if (!target.ok) {
+                return target;
+            }
+            entries.push([target.value, converted.files[name] ?? '']);
+        }
+    }
+    const planned = [];
+    for (const [path, text] of entries) {
+        const current = await readIfExists(path);
+        const file = {
+            path,
+            text,
+            bytes: Buffer.byteLength(text, 'utf8'),
+            lines: countLines(text),
+            state: current === undefined
+                ? 'created'
+                : current === text
+                    ? 'unchanged'
+                    : 'changed',
+        };
+        if (current !== undefined && current !== text) {
+            file.diff = summarizeDiff(current, text);
+        }
+        planned.push(file);
+    }
+    return ok(planned);
+}
+async function classifyPath(path) {
+    try {
+        const info = await stat(path);
+        if (info.isDirectory()) {
+            return 'directory';
+        }
+        return info.isFile() ? 'file' : 'other';
+    }
+    catch {
+        return 'missing';
+    }
+}
+async function readIfExists(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Resolves an emitter-provided relative path under the output directory, rejecting escapes. */
+function resolveInside(directory, relativePath) {
+    if (relativePath === '' ||
+        isAbsolute(relativePath) ||
+        relativePath.split(/[\\/]/).includes('..')) {
+        return err('EMIT_FAILED', `The emitter returned the file path "${relativePath}", which is not a relative path inside the output directory.`);
+    }
+    return ok(resolve(directory, relativePath));
+}
+/** Counts lines the way an editor does: a trailing newline does not add a line. */
+export function countLines(text) {
+    if (text === '') {
+        return 0;
+    }
+    const newlines = text.split('\n').length - 1;
+    return text.endsWith('\n') ? newlines : newlines + 1;
+}
+/**
+ * Describes how two texts differ in a short line, for example
+ * "+3 -1 lines (first difference at line 12)".
+ */
+export function summarizeDiff(before, after) {
+    const oldLines = before.split('\n');
+    const newLines = after.split('\n');
+    const counts = new Map();
+    for (const line of oldLines) {
+        counts.set(line, (counts.get(line) ?? 0) + 1);
+    }
+    let added = 0;
+    for (const line of newLines) {
+        const remaining = counts.get(line) ?? 0;
+        if (remaining > 0) {
+            counts.set(line, remaining - 1);
+        }
+        else {
+            added += 1;
+        }
+    }
+    let removed = 0;
+    for (const remaining of counts.values()) {
+        removed += remaining;
+    }
+    let first = 0;
+    while (first < oldLines.length &&
+        first < newLines.length &&
+        oldLines[first] === newLines[first]) {
+        first += 1;
+    }
+    return `+${added} -${removed} lines (first difference at line ${first + 1})`;
+}
+async function readTextFile(filePath) {
+    try {
+        return ok(await readFile(filePath, 'utf8'));
+    }
+    catch (thrown) {
+        return err('INPUT_READ_FAILED', `Could not read "${filePath}": ${describeThrown(thrown)}`);
+    }
+}
+async function writeTextFile(outputPath, text) {
+    const absolutePath = resolve(outputPath);
+    try {
+        await mkdir(dirname(absolutePath), { recursive: true });
+        await writeFile(absolutePath, text, 'utf8');
+        return ok(absolutePath);
+    }
+    catch (thrown) {
+        return err('OUTPUT_WRITE_FAILED', `Could not write the output file "${absolutePath}": ${describeThrown(thrown)}`);
+    }
+}
+/** Derives a Django app label from the location of a models.py file or models/ package. */
+export function deriveAppLabel(filePath) {
+    const absolutePath = resolve(filePath);
+    const directory = dirname(absolutePath);
+    if (basename(directory) === 'models') {
+        return basename(dirname(directory));
+    }
+    return basename(directory);
+}
+async function discoverInputFiles(inputs, format) {
+    const files = [];
+    for (const input of inputs) {
+        let inputStat;
+        try {
+            inputStat = await stat(input);
+        }
+        catch {
+            return err('INPUT_NOT_FOUND', `The input path "${input}" does not exist or is not readable.`);
+        }
+        if (inputStat.isDirectory()) {
+            const roots = format === 'laravel' ? await laravelRoots(input) : [input];
+            for (const root of roots) {
+                files.push(...(await walkDirectory(root, format)));
+            }
+        }
+        else {
+            files.push(input);
+        }
+    }
+    if (files.length === 0) {
+        const expected = format === 'django'
+            ? 'models.py files (or a models/ package)'
+            : format === 'typeorm'
+                ? 'TypeScript (.ts) entity files'
+                : format === 'doctrine'
+                    ? 'PHP (.php) entity files'
+                    : format === 'laravel'
+                        ? 'PHP (.php) migration and model files (database/migrations and app/)'
+                        : '.prisma files';
+        return err('NO_INPUT_FILES', `No ${expected} were found in: ${inputs.join(', ')}.`);
+    }
+    return ok(files);
+}
+function isRelevantFile(filePath, format) {
+    if (format === 'prisma') {
+        return extname(filePath) === '.prisma';
+    }
+    if (format === 'typeorm') {
+        return (extname(filePath) === '.ts' &&
+            !/\.(d|test|spec)\.ts$/.test(basename(filePath)));
+    }
+    if (format === 'doctrine' || format === 'laravel') {
+        return (extname(filePath) === '.php' && !/Test\.php$/.test(basename(filePath)));
+    }
+    const parentName = basename(dirname(filePath));
+    const fileName = basename(filePath);
+    if (fileName === 'models.py') {
+        return true;
+    }
+    return (parentName === 'models' &&
+        extname(fileName) === '.py' &&
+        fileName !== '__init__.py');
+}
+function isSkippedDirectory(name, parent, format) {
+    if (format === 'laravel') {
+        // bootstrap/cache holds generated files; the rest of bootstrap/ is ordinary code.
+        return (LARAVEL_SKIPPED_DIRECTORIES.has(name) ||
+            (name === 'cache' && basename(parent) === 'bootstrap'));
+    }
+    return (SKIPPED_DIRECTORIES.has(name) ||
+        (format === 'doctrine' && PHP_SKIPPED_DIRECTORIES.has(name)));
+}
+/**
+ * For a Laravel project root (it has `database/migrations` or `app`), only those
+ * two directories are read. Any other directory, such as `app/Models` or
+ * `database/migrations` passed on its own, is read as given.
+ */
+async function laravelRoots(directory) {
+    const roots = [];
+    for (const candidate of [
+        join(directory, 'database', 'migrations'),
+        join(directory, 'app'),
+    ]) {
+        if ((await classifyPath(candidate)) === 'directory') {
+            roots.push(candidate);
+        }
+    }
+    return roots.length > 0 ? roots : [directory];
+}
+async function walkDirectory(directory, format) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    const found = [];
+    for (const entry of entries.sort((first, second) => first.name.localeCompare(second.name))) {
+        const entryPath = join(directory, entry.name);
+        if (entry.isDirectory()) {
+            if (!isSkippedDirectory(entry.name, directory, format)) {
+                found.push(...(await walkDirectory(entryPath, format)));
+            }
+        }
+        else if (isRelevantFile(entryPath, format)) {
+            found.push(entryPath);
+        }
+    }
+    return found;
+}
+//# sourceMappingURL=io.js.map