@venizia/ardor 0.4.6-1 → 0.4.7-0

package/README.md

@@ -13,6 +13,24 @@ control comes from `@venizia/ignis-inversion`, and the data layer speaks the que
 bun add @venizia/ardor @venizia/ignis-inversion @venizia/ignis-filter @venizia/ignis-kernel @venizia/ignis-helpers reflect-metadata
 ```
 
+## The `Ardor` namespace
+
+`Ardor` gathers every React hook of the react and admin packages under one name: `Ardor.useRepository(...)`, `Ardor.useTranslate()`. It is the same function as the bare `useRepository`, the Rules of Hooks check the call, and a bundler keeps only the hooks you use, so it adds no bytes to an app.
+
+```tsx
+import { Ardor } from '@venizia/ardor';
+
+export const Orders = () => {
+  const repository = Ardor.useRepository({ key: 'repositories.Orders' });
+
+  return <div>{String(repository)}</div>;
+};
+```
+
+## Moving to the new names
+
+`bun run ardor codemod namespace src` lists the removed bare names that have a replacement (`getRuntimeConfig` to `RuntimeConfig.get`, `isDefined` to `ValueUtility.isDefined`, `NullableType` to `undefined | null | void`, `Logger.getInstance({ scope })` to `LoggerFactory.getLogger([scope])`, ...) and the removed names with none, and writes nothing; `--write` applies it, `--check` fails while any is left, and `--hooks` also moves hooks imported from `@venizia/ardor` to `Ardor.useX`. It needs the `typescript` package.
+
 ## Quick start
 
 ```typescript

package/dist/ardor.d.ts

@@ -0,0 +1,3 @@
+export { useDocumentTitle, useFeatures, useHtmlLang, useNotifyError, useRefreshToken, useRequestHeaderLocale, useTranslate, } from '@venizia/ardor-admin';
+export { useApplicationContext, useApplicationLogger, useAutosave, useBeforeUnload, useComponent, useConfiguration, useConfirm, useCopyToClipboard, useDebounce, useInjectable, useInjectableContainer, useProvider, useRepository, useService, useSizer, useWindowDimensions, } from '@venizia/ardor-react';
+//# sourceMappingURL=ardor.d.ts.map

package/dist/ardor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ardor.d.ts","sourceRoot":"","sources":["../src/ardor.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,EACR,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/ardor.js

@@ -0,0 +1,11 @@
+// Every ARDOR hook, gathered for `export * as Ardor` in index.ts: one name, `Ardor.useRepository(...)`,
+// the way `React.useState` is one. Each member is the very function the react or admin package
+// exports. The React Rules of Hooks recognise a call through a PascalCase identifier, so
+// `Ardor.useX()` is checked like `useX()`. It sits in `@venizia/ardor` because react cannot import
+// admin; the two packages keep their own top-level exports.
+//
+// A module namespace, not an object literal: a bundler resolves `Ardor.useRepository` to that one
+// hook and drops the rest, where an object that lists them all would pull every hook in.
+export { useDocumentTitle, useFeatures, useHtmlLang, useNotifyError, useRefreshToken, useRequestHeaderLocale, useTranslate, } from '@venizia/ardor-admin';
+export { useApplicationContext, useApplicationLogger, useAutosave, useBeforeUnload, useComponent, useConfiguration, useConfirm, useCopyToClipboard, useDebounce, useInjectable, useInjectableContainer, useProvider, useRepository, useService, useSizer, useWindowDimensions, } from '@venizia/ardor-react';
+//# sourceMappingURL=ardor.js.map

package/dist/ardor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ardor.js","sourceRoot":"","sources":["../src/ardor.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,+FAA+F;AAC/F,yFAAyF;AACzF,mGAAmG;AACnG,4DAA4D;AAC5D,EAAE;AACF,kGAAkG;AAClG,yFAAyF;AACzF,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,UAAU,EACV,QAAQ,EACR,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/codemod/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/codemod/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/codemod/bin.ts"],"names":[],"mappings":""}

package/dist/codemod/bin.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { NamespaceCommand } from './cli.js';
+const USAGE = `Usage: ardor <command>
+
+Commands:
+  codemod namespace   move the deprecated bare names to the class members that replace them
+
+Run "ardor codemod namespace --help" for the options.`;
+/** The `ardor` bin of `@venizia/ardor`: `ardor codemod namespace [paths...] [--write | --check]`. */
+const main = async () => {
+    const [command, name, ...rest] = process.argv.slice(2);
+    if (command === 'codemod' && name === 'namespace') {
+        return NamespaceCommand.run({ root: process.cwd(), args: rest });
+    }
+    if (command === undefined || command === '--help' || command === '-h') {
+        console.log(USAGE);
+        return 0;
+    }
+    console.error(`ardor: unknown command "${[command, name].filter(Boolean).join(' ')}"\n${USAGE}`);
+    return 2;
+};
+const result = await main();
+process.exitCode = result;
+//# sourceMappingURL=bin.js.map

package/dist/codemod/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/codemod/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAEzC,MAAM,KAAK,GAAG;;;;;sDAKwC,CAAC;AAEvD,qGAAqG;AACrG,MAAM,IAAI,GAAG,KAAK,IAAqB,EAAE;IACvC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEvD,IAAI,OAAO,KAAK,SAAS,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QAClD,OAAO,gBAAgB,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEnB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IAEjG,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;AAC5B,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC"}

package/dist/codemod/cli.d.ts

@@ -0,0 +1,13 @@
+/** `ardor codemod namespace`: a dry run unless `--write`; `--check` is the dry run that fails on work left. */
+export declare class NamespaceCommand {
+    static readonly USAGE = "Usage: ardor codemod namespace [paths...] [--hooks] [--write | --check]\n\nMoves the names removed from @venizia/ardor to what replaces them:\n\n  isDefined, isString, isNumber, isObject, isValidDate   ValueUtility.<name>\n  isBrowser                                             BrowserUtility.isBrowser\n  toDataUrl                                             FileUtility.toDataUrl\n  getRuntimeConfig                                      RuntimeConfig.get\n  createAppDispatch, createAppSelectors                 DispatchHooks.create, SelectorHooks.create\n  resolveApplicationProviders                           ApplicationProviders.resolve\n  hasPendingFeatureMessages, loadFeatureMessages        Features.hasPendingMessages, Features.loadMessages\n  NumberIdType, StringIdType, NullableType              number, string, undefined | null | void\n  BaseHelper, LogLevels, ILogger, TLogLevel             the same names from @venizia/ignis-helpers/core\n  Logger.getInstance({ scope }), new Logger({ scope })  LoggerFactory.getLogger([scope]) (enableDebug is dropped, with a note)\n  Logger (a type)                                       ILogger\n\nRemoved with nothing to write in their place, so only listed with their line: isEditableTarget,\nTDataCount, ISyncFC, App.DEFAULT_LOCALE, HeaderConstants.REQUEST_DEVICE_INFO, HeaderConstants.RESPONSE_FORMAT,\nthe enableDebug prop of ArdorApplication (pass logger instead), and a Logger use with no one-line form.\n\nIt rewrites a name imported from @venizia/ardor, @venizia/ardor-kernel, @venizia/ardor-react or\n@venizia/ardor-admin, its uses, and the import. It reads syntax only: a name the file also declares\nitself, a re-export by name and a class name already taken are listed with their line and left for you.\n\n  --hooks    also move a hook imported from @venizia/ardor to the Ardor namespace (useRepository()\n             becomes Ardor.useRepository()). A hook imported from @venizia/ardor-react or\n             @venizia/ardor-admin is never touched: those packages cannot import Ardor.\n  --write    write the changed files (without it, nothing is written)\n  --check    dry run that exits 1 when anything would change or is left (for CI)\n  --help     print this text and exit\n\nWith no flag it lists what would change and writes nothing. Inside a git repository it reads the\nfiles git knows (tracked, or untracked and not ignored), and --write refuses a file with local\nchanges (changed, staged or untracked): commit or stash it first, so git can undo the codemod.\nRun your formatter afterwards: the new names are appended to the import they join.";
+    /** Runs the command and returns the exit code; prints to the console. */
+    static run(opts: {
+        root: string;
+        args: string[];
+    }): Promise<number>;
+    private static loadTypeScript;
+    private static sweep;
+    private static report;
+}
+//# sourceMappingURL=cli.d.ts.map

package/dist/codemod/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/codemod/cli.ts"],"names":[],"mappings":"AAkEA,+GAA+G;AAC/G,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,KAAK,+jFAAS;IAE9B,yEAAyE;WAC5D,GAAG,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;mBAiDpD,cAAc;IAYnC,OAAO,CAAC,MAAM,CAAC,KAAK;IA6CpB,OAAO,CAAC,MAAM,CAAC,MAAM;CA0CtB"}

package/dist/codemod/cli.js

@@ -0,0 +1,155 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { relative, resolve } from 'node:path';
+import { CodemodFiles } from './files.js';
+import { Migration } from './migrate.js';
+const USAGE = `Usage: ardor codemod namespace [paths...] [--hooks] [--write | --check]
+
+Moves the names removed from @venizia/ardor to what replaces them:
+
+  isDefined, isString, isNumber, isObject, isValidDate   ValueUtility.<name>
+  isBrowser                                             BrowserUtility.isBrowser
+  toDataUrl                                             FileUtility.toDataUrl
+  getRuntimeConfig                                      RuntimeConfig.get
+  createAppDispatch, createAppSelectors                 DispatchHooks.create, SelectorHooks.create
+  resolveApplicationProviders                           ApplicationProviders.resolve
+  hasPendingFeatureMessages, loadFeatureMessages        Features.hasPendingMessages, Features.loadMessages
+  NumberIdType, StringIdType, NullableType              number, string, undefined | null | void
+  BaseHelper, LogLevels, ILogger, TLogLevel             the same names from @venizia/ignis-helpers/core
+  Logger.getInstance({ scope }), new Logger({ scope })  LoggerFactory.getLogger([scope]) (enableDebug is dropped, with a note)
+  Logger (a type)                                       ILogger
+
+Removed with nothing to write in their place, so only listed with their line: isEditableTarget,
+TDataCount, ISyncFC, App.DEFAULT_LOCALE, HeaderConstants.REQUEST_DEVICE_INFO, HeaderConstants.RESPONSE_FORMAT,
+the enableDebug prop of ArdorApplication (pass logger instead), and a Logger use with no one-line form.
+
+It rewrites a name imported from @venizia/ardor, @venizia/ardor-kernel, @venizia/ardor-react or
+@venizia/ardor-admin, its uses, and the import. It reads syntax only: a name the file also declares
+itself, a re-export by name and a class name already taken are listed with their line and left for you.
+
+  --hooks    also move a hook imported from @venizia/ardor to the Ardor namespace (useRepository()
+             becomes Ardor.useRepository()). A hook imported from @venizia/ardor-react or
+             @venizia/ardor-admin is never touched: those packages cannot import Ardor.
+  --write    write the changed files (without it, nothing is written)
+  --check    dry run that exits 1 when anything would change or is left (for CI)
+  --help     print this text and exit
+
+With no flag it lists what would change and writes nothing. Inside a git repository it reads the
+files git knows (tracked, or untracked and not ignored), and --write refuses a file with local
+changes (changed, staged or untracked): commit or stash it first, so git can undo the codemod.
+Run your formatter afterwards: the new names are appended to the import they join.`;
+/** A usage error: nothing was read or written. */
+const USAGE_ERROR_CODE = 2;
+class CodemodFlags {
+    static { this.WRITE = '--write'; }
+    static { this.CHECK = '--check'; }
+    static { this.HOOKS = '--hooks'; }
+    static { this.HELP = '--help'; }
+    static { this.HELP_SHORT = '-h'; }
+    static { this.SCHEME_SET = new Set([
+        this.WRITE,
+        this.CHECK,
+        this.HOOKS,
+        this.HELP,
+        this.HELP_SHORT,
+    ]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+/** `ardor codemod namespace`: a dry run unless `--write`; `--check` is the dry run that fails on work left. */
+export class NamespaceCommand {
+    static { this.USAGE = USAGE; }
+    /** Runs the command and returns the exit code; prints to the console. */
+    static async run(opts) {
+        const { root, args } = opts;
+        if (args.includes(CodemodFlags.HELP) || args.includes(CodemodFlags.HELP_SHORT)) {
+            console.log(USAGE);
+            return 0;
+        }
+        const unknown = args.filter((argument) => argument.startsWith('-') && !CodemodFlags.isValid(argument));
+        if (unknown.length > 0) {
+            console.error(`ardor codemod: unknown option ${unknown.map((flag) => `"${flag}"`).join(', ')}\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        const isWrite = args.includes(CodemodFlags.WRITE);
+        const isCheck = args.includes(CodemodFlags.CHECK);
+        if (isWrite && isCheck) {
+            console.error(`ardor codemod: ${CodemodFlags.WRITE} and ${CodemodFlags.CHECK} contradict each other\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        const ts = await NamespaceCommand.loadTypeScript();
+        if (!ts) {
+            console.error('ardor codemod: the "typescript" package is not installed here. Install it (it is a dev dependency of any TypeScript project) and run again.');
+            return USAGE_ERROR_CODE;
+        }
+        const paths = args.filter((argument) => !argument.startsWith('-'));
+        const targets = (paths.length > 0 ? paths : ['.']).map((path) => resolve(root, path));
+        const hooks = args.includes(CodemodFlags.HOOKS);
+        return NamespaceCommand.sweep({ root, ts, targets, hooks, isWrite, isCheck });
+    }
+    static async loadTypeScript() {
+        try {
+            const loaded = await import('typescript');
+            // TypeScript is CommonJS: Node puts the module on `default`, a bundler may not.
+            return loaded.default ?? loaded;
+            // eslint-disable-next-line venizia/no-silent-catch -- no `typescript` installed is an answer, not a failure: the caller prints how to install it
+        }
+        catch {
+            return undefined;
+        }
+    }
+    static sweep(opts) {
+        const { root, ts, targets, hooks, isWrite, isCheck } = opts;
+        const files = [...new Set(targets.flatMap((target) => CodemodFiles.collect({ target })))];
+        const dirty = isWrite
+            ? new Set(targets.flatMap((target) => [...(CodemodFiles.dirty({ target }) ?? [])]))
+            : new Set();
+        const changes = [];
+        const refused = [];
+        const left = [];
+        const notes = [];
+        for (const path of files) {
+            const text = readFileSync(path, 'utf8');
+            const result = Migration.run({ ts, fileName: path, text, hooks });
+            for (const finding of result.findings) {
+                (finding.kind === 'note' ? notes : left).push({ path, finding });
+            }
+            if (result.text === text) {
+                continue;
+            }
+            if (isWrite && dirty.has(path)) {
+                refused.push(path);
+                continue;
+            }
+            changes.push({ path, renamed: result.renamed });
+            if (isWrite) {
+                writeFileSync(path, result.text);
+            }
+        }
+        return NamespaceCommand.report({ root, isWrite, isCheck, changes, refused, left, notes });
+    }
+    static report(opts) {
+        const { root, isWrite, isCheck, changes, refused, left, notes } = opts;
+        const verb = isWrite ? 'changed' : 'would change';
+        const show = (path) => relative(root, path) || path;
+        for (const change of changes) {
+            console.log(`${verb} ${show(change.path)} (${change.renamed} use${change.renamed === 1 ? '' : 's'})`);
+        }
+        for (const path of refused) {
+            console.error(`refused ${show(path)}: it has local changes; commit or stash it first`);
+        }
+        // A note is a change made on purpose that is worth knowing; it is not work left, so --check ignores it.
+        for (const { path, finding } of notes) {
+            console.log(`note ${show(path)}:${finding.line} ${finding.name}: ${finding.reason}`);
+        }
+        for (const { path, finding } of left) {
+            console.error(`left ${show(path)}:${finding.line} ${finding.name}: ${finding.reason}`);
+        }
+        console.log(`${changes.length} file${changes.length === 1 ? '' : 's'} ${verb}, ${left.length} left for you${isWrite || changes.length === 0 ? '' : '. Run again with --write to apply.'}`);
+        if (refused.length > 0) {
+            return 1;
+        }
+        return isCheck && (changes.length > 0 || left.length > 0) ? 1 : 0;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/codemod/cli.js.map

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

package/dist/codemod/files.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The source files a codemod may touch. Inside a git repository the list comes from git, so a
+ * `.gitignore`d folder (a worktree, a build output) is never entered; outside git the walk skips
+ * `node_modules`, `dist`, `build` and every dot-directory.
+ */
+export declare class CodemodFiles {
+    static isSource(opts: {
+        name: string;
+    }): boolean;
+    /** Every source file under `target`; a file target is returned as it is. */
+    static collect(opts: {
+        target: string;
+    }): string[];
+    /** Tracked files plus untracked files git does not ignore; `undefined` outside a repository. */
+    private static fromGit;
+    private static fromWalk;
+    /**
+     * The files under `target` a write could not be undone with git: changed, staged or untracked.
+     * `undefined` outside a repository or without git, where there is nothing to check.
+     */
+    static dirty(opts: {
+        target: string;
+    }): Set<string> | undefined;
+}
+//# sourceMappingURL=files.d.ts.map

package/dist/codemod/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/codemod/files.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAIhD,4EAA4E;IAC5E,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,EAAE;IAUlD,gGAAgG;IAChG,OAAO,CAAC,MAAM,CAAC,OAAO;IA4BtB,OAAO,CAAC,MAAM,CAAC,QAAQ;IAkBvB;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS;CAiChE"}

package/dist/codemod/files.js

@@ -0,0 +1,97 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+const SKIPPED_DIRECTORIES = new Set(['node_modules', 'dist', 'build', '.git']);
+const SOURCE_PATTERN = /\.(?:ts|tsx|mts|cts)$/;
+const DECLARATION_PATTERN = /\.d\.(?:ts|mts|cts)$/;
+/**
+ * The source files a codemod may touch. Inside a git repository the list comes from git, so a
+ * `.gitignore`d folder (a worktree, a build output) is never entered; outside git the walk skips
+ * `node_modules`, `dist`, `build` and every dot-directory.
+ */
+export class CodemodFiles {
+    static isSource(opts) {
+        return SOURCE_PATTERN.test(opts.name) && !DECLARATION_PATTERN.test(opts.name);
+    }
+    /** Every source file under `target`; a file target is returned as it is. */
+    static collect(opts) {
+        const { target } = opts;
+        if (statSync(target).isFile()) {
+            return [target];
+        }
+        return CodemodFiles.fromGit({ target }) ?? CodemodFiles.fromWalk({ target });
+    }
+    /** Tracked files plus untracked files git does not ignore; `undefined` outside a repository. */
+    static fromGit(opts) {
+        const { target } = opts;
+        let output;
+        try {
+            output = execFileSync('git', ['ls-files', '--cached', '--others', '--exclude-standard', '-z'], {
+                cwd: target,
+                encoding: 'utf8',
+                maxBuffer: 256 * 1024 * 1024,
+                stdio: ['ignore', 'pipe', 'ignore'],
+            });
+            // eslint-disable-next-line venizia/no-silent-catch -- not a git repository (or no git) is an answer: the caller walks the folder instead
+        }
+        catch {
+            return undefined;
+        }
+        return output
+            .split('\0')
+            .filter((path) => path !== '' && CodemodFiles.isSource({ name: path }))
+            .filter((path) => !path.split('/').some((segment) => SKIPPED_DIRECTORIES.has(segment)))
+            .map((path) => join(target, path))
+            .filter((path) => existsSync(path) && statSync(path).isFile());
+    }
+    static fromWalk(opts) {
+        const files = [];
+        for (const entry of readdirSync(opts.target, { withFileTypes: true })) {
+            const path = join(opts.target, entry.name);
+            if (entry.isDirectory()) {
+                if (!SKIPPED_DIRECTORIES.has(entry.name) && !entry.name.startsWith('.')) {
+                    files.push(...CodemodFiles.fromWalk({ target: path }));
+                }
+            }
+            else if (entry.isFile() && CodemodFiles.isSource({ name: entry.name })) {
+                files.push(path);
+            }
+        }
+        return files;
+    }
+    /**
+     * The files under `target` a write could not be undone with git: changed, staged or untracked.
+     * `undefined` outside a repository or without git, where there is nothing to check.
+     */
+    static dirty(opts) {
+        const { target } = opts;
+        const cwd = statSync(target).isFile() ? dirname(target) : target;
+        const queries = [
+            ['ls-files', '--modified', '--others', '--exclude-standard', '-z'],
+            ['diff', '--cached', '--name-only', '--relative', '-z'],
+        ];
+        const paths = new Set();
+        for (const query of queries) {
+            let output;
+            try {
+                output = execFileSync('git', query, {
+                    cwd,
+                    encoding: 'utf8',
+                    maxBuffer: 256 * 1024 * 1024,
+                    stdio: ['ignore', 'pipe', 'ignore'],
+                });
+                // eslint-disable-next-line venizia/no-silent-catch -- git cannot answer for this folder: the caller treats the file as unknown to git
+            }
+            catch {
+                return undefined;
+            }
+            for (const path of output.split('\0')) {
+                if (path !== '') {
+                    paths.add(join(cwd, path));
+                }
+            }
+        }
+        return paths;
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/codemod/files.js.map

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

package/dist/codemod/logger.d.ts

@@ -0,0 +1,42 @@
+import type { IFinding, TTypeScript } from './transform.js';
+export interface ILoggerResult {
+    text: string;
+    /** Call sites and annotations rewritten, and imports moved. */
+    renamed: number;
+    /** What was left, and what was changed on purpose. */
+    findings: IFinding[];
+}
+/**
+ * Moves a project off the kernel logger, which IGNIS's `ILogger` replaces:
+ *
+ * - `BaseHelper`, `LogLevels`, `ILogger` and `TLogLevel` keep their names, so only the import moves
+ *   to `@venizia/ignis-helpers/core`.
+ * - `Logger.getInstance({ scope })` and `new Logger({ scope })` become
+ *   `LoggerFactory.getLogger([scope])`. IGNIS's console logger has its own debug gate (off unless
+ *   `DEBUG` is set, and always off in a browser), so an `enableDebug` option is dropped and noted.
+ * - `Logger` as a type becomes `ILogger`.
+ * - The `enableDebug` prop of `ArdorApplication` is removed (pass `logger`): listed.
+ *
+ * Any other use of `Logger` (a subclass, `instanceof`, a spread argument) is listed and `Logger` stays
+ * imported, so the file shows exactly where to look.
+ */
+export declare class LoggerTransform {
+    static run(opts: {
+        ts: TTypeScript;
+        fileName: string;
+        text: string;
+    }): ILoggerResult;
+    private static collectImports;
+    /** `<ArdorApplication enableDebug />`: the prop is gone, the logger is passed instead. */
+    private static findEnableDebugProp;
+    /** The uses of `Logger`. `isFullyMoved` is true when none is left, so its import can go. */
+    private static rewriteLogger;
+    /** The top-level names the file already owns, other than the IGNIS ones it imports and the ARDOR ones being moved. */
+    private static takenNames;
+    /** `name` when the file does not own it, else `Ignis<name>`. */
+    private static freeName;
+    /** The ARDOR import lines without the moved names, and `@venizia/ignis-helpers/core` with them. */
+    private static importEdits;
+    private static apply;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/codemod/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/codemod/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAgBD;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;IAC1B,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa;IA8EpF,OAAO,CAAC,MAAM,CAAC,cAAc;IAqC7B,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA0ClC,4FAA4F;IAC5F,OAAO,CAAC,MAAM,CAAC,aAAa;IA4I5B,sHAAsH;IACtH,OAAO,CAAC,MAAM,CAAC,UAAU;IAuDzB,gEAAgE;IAChE,OAAO,CAAC,MAAM,CAAC,QAAQ;IAIvB,mGAAmG;IACnG,OAAO,CAAC,MAAM,CAAC,WAAW;IA2H1B,OAAO,CAAC,MAAM,CAAC,KAAK;CAWrB"}