@venizia/ardor 0.4.8-1 → 0.4.8-3

package/README.md

@@ -13,6 +13,8 @@ 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 React-side peers (`react`, `react-dom`, `react-redux`, `@reduxjs/toolkit`, `@tanstack/react-query`, `ra-core`, `ra-i18n-polyglot`, `react-router-dom`) are installed too; the full `bun add` line is in the [setup guide](https://ardor.venizia.ai/guides/get-started/setup).
+
 ## 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.
@@ -20,8 +22,10 @@ bun add @venizia/ardor @venizia/ignis-inversion @venizia/ignis-filter @venizia/i
 ```tsx
 import { Ardor } from '@venizia/ardor';
 
+import { OrdersRepository } from './orders.repository';
+
 export const Orders = () => {
-  const repository = Ardor.useRepository({ key: 'repositories.Orders' });
+  const repository = Ardor.useRepository({ target: OrdersRepository });
 
   return <div>{String(repository)}</div>;
 };
@@ -29,7 +33,13 @@ export const Orders = () => {
 
 ## 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.
+`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 (it refuses a file with local changes unless you add `--allow-dirty`), `--check` fails while any is left, and `--hooks` also moves hooks imported from `@venizia/ardor` to `Ardor.useX`. It needs the `typescript` package.
+
+## Subpaths
+
+- `@venizia/ardor/repository` - `HttpRepository` and the datasource settings; needs the optional peer `@venizia/ignis-connectors`.
+- `@venizia/ardor/testing` - `assertArdorApplicationBoots` and `FakeResizeObserver`, for your test suite.
+- `@venizia/ardor/vite` - `buildInfoFile`, a Vite plugin that writes the build info file; needs the optional peers `@venizia/ignis-boot` and `vite`.
 
 ## Quick start
 
@@ -108,7 +118,8 @@ export class Application extends BaseArdorApplication {
 ```
 
 The full guide, including the root component and the typed hooks, is in the
-[repository README](https://github.com/VENIZIA-AI/ardor#readme).
+[Quickstart](https://ardor.venizia.ai/guides/get-started/5-minute-quickstart) and the
+[references](https://ardor.venizia.ai/references/hooks).
 
 ## Migrating from `@minimaltech/ra-core-infra`
 

package/dist/codemod/bin.js

@@ -3,7 +3,7 @@ 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
+  codemod namespace   move the removed 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]`. */

package/dist/codemod/cli.d.ts

@@ -1,6 +1,6 @@
 /** `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 [--allow-dirty] | --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  --allow-dirty  with --write, also write a file that has local changes, such as one another codemod\n             just changed (devz codemod namespace-functions --write leaves the tree dirty)\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), so git can undo the codemod: the file is listed as \"refused\"\nwith its path, the summary counts it and the run exits 1. Commit or stash it and run again, or run\nagain with --allow-dirty to write it anyway (it keeps the other codemod's edits). To run two codemods\none after the other in a dirty tree, give this one --write --allow-dirty.\nRun your formatter afterwards: the new names are appended to the import they join.";
+    static readonly USAGE = "Usage: ardor codemod namespace [paths...] [--hooks] [--write [--allow-dirty] | --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  ISendResponse                                         INetworkResponse\n\nRemoved with nothing to write in their place, so only listed with their line: isEditableTarget,\nTDataCount, ISyncFC, IListFilter.offset (use skip; listed wherever a file that imports IListFilter or ListFilterBuilder reads or sets .offset), useSizer (use useElementSize), useInjectableContainer (renamed useApplicationContainer), 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  --allow-dirty  with --write, also write a file that has local changes, such as one another codemod\n             just changed (devz codemod namespace-functions --write leaves the tree dirty)\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), so git can undo the codemod: the file is listed as \"refused\"\nwith its path, the summary counts it and the run exits 1. Commit or stash it and run again, or run\nagain with --allow-dirty to write it anyway (it keeps the other codemod's edits). To run two codemods\none after the other in a dirty tree, give this one --write --allow-dirty.\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;

package/dist/codemod/cli.js

@@ -17,9 +17,10 @@ Moves the names removed from @venizia/ardor to what replaces them:
   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
+  ISendResponse                                         INetworkResponse
 
 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,
+TDataCount, ISyncFC, IListFilter.offset (use skip; listed wherever a file that imports IListFilter or ListFilterBuilder reads or sets .offset), useSizer (use useElementSize), useInjectableContainer (renamed useApplicationContainer), 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

package/dist/codemod/logger.js

@@ -179,7 +179,7 @@ export class LoggerTransform {
                 findings.push({
                     line: lineOf(call),
                     name: 'enableDebug',
-                    reason: 'note: dropped. debug lines are off by default now (a browser, or `DEBUG` unset); turn them on with `LoggerFactory.use({ level: LogLevels.DEBUG })` at startup',
+                    reason: 'dropped. debug lines are off by default now (a browser, or `DEBUG` unset); turn them on with `LoggerFactory.use({ level: LogLevels.DEBUG })` at startup',
                     kind: 'note',
                 });
             }

package/dist/codemod/renames.d.ts

@@ -34,11 +34,23 @@ export declare class TypeRenames {
         name: string;
     }): string | undefined;
 }
+/** Types removed in favour of another export of the same packages: the import and each use are renamed. */
+export declare class TypeExportRenames {
+    static readonly TARGETS: Readonly<Record<string, string>>;
+    static find(opts: {
+        name: string;
+    }): string | undefined;
+}
 /** Exports and members removed with no code the codemod can write in their place. */
 export declare class RemovedNames {
     static readonly EXPORTS: Readonly<Record<string, string>>;
     /** Class name to removed static member to the reason. */
     static readonly MEMBERS: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** A property removed from the list filter: listed in a file that imports one of `owners`, as the file may use it. */
+    static readonly PROPERTIES: Readonly<Record<string, {
+        owners: ReadonlySet<string>;
+        reason: string;
+    }>>;
     static findExport(opts: {
         name: string;
     }): string | undefined;

package/dist/codemod/renames.js

@@ -85,12 +85,23 @@ export class TypeRenames {
         return Object.hasOwn(this.TARGETS, opts.name) ? this.TARGETS[opts.name] : undefined;
     }
 }
+/** Types removed in favour of another export of the same packages: the import and each use are renamed. */
+export class TypeExportRenames {
+    static { this.TARGETS = {
+        ISendResponse: 'INetworkResponse',
+    }; }
+    static find(opts) {
+        return Object.hasOwn(this.TARGETS, opts.name) ? this.TARGETS[opts.name] : undefined;
+    }
+}
 /** Exports and members removed with no code the codemod can write in their place. */
 export class RemovedNames {
     static { this.EXPORTS = {
         isEditableTarget: 'nothing in ARDOR called it; check the event target in your own code',
         TDataCount: 'nothing in ARDOR used it; declare the shape you need',
         ISyncFC: 'write the function type, (props: TProps) => ReactNode',
+        useInjectableContainer: 'renamed: call useApplicationContainer',
+        useSizer: 'use useElementSize({ ref, box: "border-box", round: true }) with a ref in place of the id',
     }; }
     /** Class name to removed static member to the reason. */
     static { this.MEMBERS = {
@@ -100,6 +111,13 @@ export class RemovedNames {
             RESPONSE_FORMAT: 'nothing in ARDOR sent or read this header',
         },
     }; }
+    /** A property removed from the list filter: listed in a file that imports one of `owners`, as the file may use it. */
+    static { this.PROPERTIES = {
+        offset: {
+            owners: new Set(['IListFilter', 'ListFilterBuilder']),
+            reason: 'the list filter has no offset, use skip',
+        },
+    }; }
     static findExport(opts) {
         return Object.hasOwn(this.EXPORTS, opts.name) ? this.EXPORTS[opts.name] : undefined;
     }

package/dist/codemod/transform.d.ts

@@ -15,7 +15,7 @@ export interface INamespaceResult {
     findings: IFinding[];
 }
 /**
- * Rewrites the deprecated bare names of `@venizia/ardor` to their class members, in source text:
+ * Rewrites the removed bare names of `@venizia/ardor` to their class members, in source text:
  * `isDefined(x)` becomes `ValueUtility.isDefined(x)` and the import follows. With `hooks`, a hook
  * imported from `@venizia/ardor` itself becomes `Ardor.useX` (never one imported from the react or
  * admin package, which cannot import `Ardor`).

package/dist/codemod/transform.js

@@ -1,6 +1,6 @@
-import { FunctionRenames, HookRenames, NamespaceModules, RemovedNames, TypeRenames, } from './renames.js';
+import { FunctionRenames, HookRenames, NamespaceModules, RemovedNames, TypeExportRenames, TypeRenames, } from './renames.js';
 /**
- * Rewrites the deprecated bare names of `@venizia/ardor` to their class members, in source text:
+ * Rewrites the removed bare names of `@venizia/ardor` to their class members, in source text:
  * `isDefined(x)` becomes `ValueUtility.isDefined(x)` and the import follows. With `hooks`, a hook
  * imported from `@venizia/ardor` itself becomes `Ardor.useX` (never one imported from the react or
  * admin package, which cannot import `Ardor`).
@@ -66,13 +66,15 @@ export class NamespaceTransform {
                     });
                     continue;
                 }
-                const typeText = TypeRenames.find({ name: imported });
+                const exportName = TypeExportRenames.find({ name: imported });
+                const typeText = exportName ?? TypeRenames.find({ name: imported });
                 if (typeText) {
                     renames.push({
                         specifier,
                         declaration: statement,
                         local: specifier.name.text,
                         typeText,
+                        importName: exportName,
                         references: [],
                     });
                     continue;
@@ -139,7 +141,9 @@ export class NamespaceTransform {
             else if ((ts.isFunctionDeclaration(node) ||
                 ts.isClassDeclaration(node) ||
                 ts.isFunctionExpression(node) ||
-                ts.isClassExpression(node)) &&
+                ts.isClassExpression(node) ||
+                ts.isTypeAliasDeclaration(node) ||
+                ts.isInterfaceDeclaration(node)) &&
                 node.name) {
                 declared.add(node.name.text);
             }
@@ -162,6 +166,18 @@ export class NamespaceTransform {
                 });
                 return false;
             }
+            const { importName } = rename;
+            const takenBy = importName ? bindings.imported.get(importName) : undefined;
+            if (importName &&
+                (bindings.declared.has(importName) ||
+                    (takenBy && !NamespaceModules.isValid(takenBy.module)))) {
+                findings.push({
+                    line,
+                    name: rename.local,
+                    reason: `"${importName}" is already taken in this file; import it under another name and use it in place of ${rename.local}`,
+                });
+                return false;
+            }
             if (!owner || !rename.target) {
                 return true;
             }
@@ -240,7 +256,8 @@ export class NamespaceTransform {
         }
         if (rename.typeText !== undefined) {
             // A type is a name in a type position only: `NullableType[]` needs parentheses once replaced.
-            if (ts.isTypeReferenceNode(parent) && parent.typeName === node) {
+            if ((ts.isTypeReferenceNode(parent) && parent.typeName === node) ||
+                (ts.isExpressionWithTypeArguments(parent) && parent.expression === node)) {
                 const grand = parent.parent;
                 const wrap = rename.typeText.includes('|') &&
                     (ts.isArrayTypeNode(grand) ||
@@ -278,7 +295,32 @@ export class NamespaceTransform {
         if (owners.size === 0) {
             return;
         }
+        const imported = new Set(owners.values());
         const visit = (node) => {
+            let name;
+            if (ts.isPropertyAccessExpression(node) ||
+                ts.isPropertyAssignment(node) ||
+                ts.isShorthandPropertyAssignment(node)) {
+                name = node.name;
+            }
+            else if (ts.isBindingElement(node) && ts.isObjectBindingPattern(node.parent)) {
+                name = node.propertyName ?? node.name;
+            }
+            else if (ts.isElementAccessExpression(node) &&
+                ts.isStringLiteral(node.argumentExpression)) {
+                name = node.argumentExpression;
+            }
+            const key = name && (ts.isIdentifier(name) || ts.isStringLiteral(name)) ? name : undefined;
+            const property = key && Object.hasOwn(RemovedNames.PROPERTIES, key.text)
+                ? RemovedNames.PROPERTIES[key.text]
+                : undefined;
+            if (key && property && [...property.owners].some((owner) => imported.has(owner))) {
+                findings.push({
+                    line: sourceFile.getLineAndCharacterOfPosition(key.getStart(sourceFile)).line + 1,
+                    name: `.${key.text}`,
+                    reason: `removed: ${property.reason}`,
+                });
+            }
             if (ts.isPropertyAccessExpression(node) && ts.isIdentifier(node.expression)) {
                 const owner = owners.get(node.expression.text);
                 const reason = owner
@@ -323,7 +365,17 @@ export class NamespaceTransform {
             for (const owner of owners) {
                 added.add(owner);
             }
-            const names = [...kept, ...owners];
+            const types = [];
+            for (const { declaration: from, importName, specifier } of used) {
+                if (from === declaration &&
+                    importName &&
+                    !bindings.imported.has(importName) &&
+                    !added.has(importName)) {
+                    added.add(importName);
+                    types.push(`${specifier.isTypeOnly ? 'type ' : ''}${importName}`);
+                }
+            }
+            const names = [...kept, ...owners, ...types];
             if (names.length === 0) {
                 edits.push(NamespaceTransform.removeImport({ sourceFile, declaration, clause, named, ts }));
                 continue;

package/dist/index.d.ts

@@ -1,3 +1,24 @@
+/**
+ * Every ARDOR hook under one name: `Ardor.useRepository(...)` is the same function as
+ * `useRepository`. Call a member by its name; do not index with a computed key (`Ardor[name]`), which
+ * keeps every hook in a bundle.
+ *
+ * @example
+ * ```tsx
+ * import { Ardor, repository } from '@venizia/ardor';
+ *
+ * @repository()
+ * class OrdersRepository {
+ *   count() { return 3; }
+ * }
+ *
+ * export const Orders = () => {
+ *   const orders = Ardor.useRepository({ target: OrdersRepository });
+ *   const container = Ardor.useApplicationContainer();
+ *   return <span>{orders.count()} {container.isBound({ key: 'repositories.OrdersRepository' }) ? 'bound' : 'missing'}</span>;
+ * };
+ * ```
+ */
 export * as Ardor from './ardor.js';
 export * from '@venizia/ardor-kernel';
 export * from '@venizia/ardor-react';

package/dist/index.js

@@ -1,6 +1,27 @@
 // ARDOR - one entry point over the framework packages.
 // An application imports from `@venizia/ardor`; a consumer that needs only one layer installs that
 // package directly.
+/**
+ * Every ARDOR hook under one name: `Ardor.useRepository(...)` is the same function as
+ * `useRepository`. Call a member by its name; do not index with a computed key (`Ardor[name]`), which
+ * keeps every hook in a bundle.
+ *
+ * @example
+ * ```tsx
+ * import { Ardor, repository } from '@venizia/ardor';
+ *
+ * @repository()
+ * class OrdersRepository {
+ *   count() { return 3; }
+ * }
+ *
+ * export const Orders = () => {
+ *   const orders = Ardor.useRepository({ target: OrdersRepository });
+ *   const container = Ardor.useApplicationContainer();
+ *   return <span>{orders.count()} {container.isBound({ key: 'repositories.OrdersRepository' }) ? 'bound' : 'missing'}</span>;
+ * };
+ * ```
+ */
 export * as Ardor from './ardor.js';
 export * from '@venizia/ardor-kernel';
 export * from '@venizia/ardor-react';

package/dist/presets/app/preset.json

@@ -13,12 +13,12 @@
   "dependencies": {
     "@reduxjs/toolkit": "^2.13.0",
     "@tanstack/react-query": "^5.104.5",
-    "@venizia/ardor": "0.4.8-1",
-    "@venizia/ignis-connectors": "0.4.8-0",
-    "@venizia/ignis-filter": "0.4.7-0",
-    "@venizia/ignis-helpers": "0.4.8-0",
-    "@venizia/ignis-inversion": "0.4.7-0",
-    "@venizia/ignis-kernel": "0.4.8-0",
+    "@venizia/ardor": "0.4.8-3",
+    "@venizia/ignis-connectors": "0.4.8-2",
+    "@venizia/ignis-filter": "0.4.7-2",
+    "@venizia/ignis-helpers": "0.4.8-2",
+    "@venizia/ignis-inversion": "0.4.7-2",
+    "@venizia/ignis-kernel": "0.4.8-2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "ra-core": "^5.15.5",
@@ -35,8 +35,8 @@
     "@types/bun": "^1.4.3",
     "@types/react": "^19",
     "@types/react-dom": "^19",
-    "@venizia/dev-configs": "0.4.8-0",
-    "@venizia/ignis-boot": "0.4.8-0",
+    "@venizia/dev-configs": "0.4.8-2",
+    "@venizia/ignis-boot": "0.4.8-2",
     "@vitejs/plugin-react": "^6.1.2",
     "eslint": "^10.13.0",
     "oxlint": "1.89.0",
@@ -47,11 +47,11 @@
   },
   "peers": {
     "@venizia/dev-configs": "^0.4.0 || ^0.4.8-0",
-    "@venizia/ignis-connectors": "^0.4.8-0",
-    "@venizia/ignis-filter": "^0.4.7-0",
-    "@venizia/ignis-helpers": "^0.4.8-0",
-    "@venizia/ignis-inversion": "^0.4.7-0",
-    "@venizia/ignis-kernel": "^0.4.8-0"
+    "@venizia/ignis-connectors": "^0.4.8-2",
+    "@venizia/ignis-filter": "^0.4.7-2",
+    "@venizia/ignis-helpers": "^0.4.8-2",
+    "@venizia/ignis-inversion": "^0.4.7-2",
+    "@venizia/ignis-kernel": "^0.4.8-2"
   },
   "scripts": {
     "server:dev": "vite --config .configs/builders/vite.config.mts",

package/dist/presets/lib/preset.json

@@ -5,14 +5,14 @@
   "devDependencies": {
     "@types/bun": "^1.4.3",
     "@types/react": "^19",
-    "@venizia/ardor": "^0.4.8-1",
-    "@venizia/dev-configs": "0.4.8-0",
-    "@venizia/ignis-boot": "0.4.8-0",
-    "@venizia/ignis-connectors": "0.4.8-0",
-    "@venizia/ignis-filter": "0.4.7-0",
-    "@venizia/ignis-helpers": "0.4.8-0",
-    "@venizia/ignis-inversion": "0.4.7-0",
-    "@venizia/ignis-kernel": "0.4.8-0",
+    "@venizia/ardor": "^0.4.8-3",
+    "@venizia/dev-configs": "0.4.8-2",
+    "@venizia/ignis-boot": "0.4.8-2",
+    "@venizia/ignis-connectors": "0.4.8-2",
+    "@venizia/ignis-filter": "0.4.7-2",
+    "@venizia/ignis-helpers": "0.4.8-2",
+    "@venizia/ignis-inversion": "0.4.7-2",
+    "@venizia/ignis-kernel": "0.4.8-2",
     "eslint": "^10.13.0",
     "oxlint": "1.89.0",
     "oxlint-tsgolint": "7.0.2004",
@@ -23,7 +23,7 @@
     "typescript": "^6.0.3"
   },
   "peerDependencies": {
-    "@venizia/ardor": "^0.4.8-1",
+    "@venizia/ardor": "^0.4.8-3",
     "react": "^19.3.1",
     "react-dom": "^19.3.1",
     "react-router-dom": "^7.18.4",

package/dist/testing.d.ts

@@ -2,6 +2,7 @@ import * as inversion from '@venizia/ignis-inversion';
 import { type BaseArdorApplication } from '@venizia/ardor-kernel';
 /** A class (matched exactly), a class name, or a binding key; the shape the shared core takes. */
 export type TBootSkip = inversion.TBindingSkip;
+/** What `assertArdorApplicationBoots` leaves out, which locale it loads, and when an empty application passes. */
 export interface IAssertArdorApplicationBootsOptions {
     /**
      * Bindings the check leaves unresolved, for the few that open a socket or read the page when
@@ -16,8 +17,9 @@ export interface IAssertArdorApplicationBootsOptions {
     /** The locale whose messages must load. Default: the i18n provider's initial one. */
     locale?: string;
     /**
-     * Default `false`: an application with no service, repository, datasource, component or
-     * configuration and no feature proves nothing (usually the artifact index was empty).
+     * An application with no service, repository, datasource, component or configuration and no
+     * feature proves nothing (usually the artifact index was empty), so it fails unless this is `true`.
+     * @default false
      */
     allowEmpty?: boolean;
 }

package/dist/vite/common/constants.d.ts

@@ -1,10 +1,16 @@
+/** The build info file's path when `fileName` is not set. */
 export declare const DEFAULT_BUILD_INFO_FILE_NAME = "build-info.json";
+/** The package-name prefix listed under `frameworks` when `frameworkScope` is not set. */
 export declare const DEFAULT_FRAMEWORK_SCOPE = "@venizia/";
 /** What to do when the commit is neither in the pipeline environment nor in git. */
 export declare class UnresolvedPolicies {
+    /** The build fails. */
     static readonly ERROR = "error";
+    /** The build goes on with the commit recorded as `unspecified`. */
     static readonly UNSPECIFIED = "unspecified";
+    /** Every accepted policy value. */
     static readonly SCHEME_SET: Set<string>;
+    /** Whether `value` is one of the policies. */
     static isValid(value: string): boolean;
 }
 //# sourceMappingURL=constants.d.ts.map

package/dist/vite/common/constants.js

@@ -1,10 +1,16 @@
+/** The build info file's path when `fileName` is not set. */
 export const DEFAULT_BUILD_INFO_FILE_NAME = 'build-info.json';
+/** The package-name prefix listed under `frameworks` when `frameworkScope` is not set. */
 export const DEFAULT_FRAMEWORK_SCOPE = '@venizia/';
 /** What to do when the commit is neither in the pipeline environment nor in git. */
 export class UnresolvedPolicies {
+    /** The build fails. */
     static { this.ERROR = 'error'; }
+    /** The build goes on with the commit recorded as `unspecified`. */
     static { this.UNSPECIFIED = 'unspecified'; }
+    /** Every accepted policy value. */
     static { this.SCHEME_SET = new Set([this.ERROR, this.UNSPECIFIED]); }
+    /** Whether `value` is one of the policies. */
     static isValid(value) {
         return this.SCHEME_SET.has(value);
     }

package/dist/vite/common/types.d.ts

@@ -1,15 +1,31 @@
 import type { IBuildInfoFile, TConstValue } from '@venizia/ardor-kernel';
 import type { TBuildInfoRecord } from '@venizia/ignis-helpers/core';
 import type { UnresolvedPolicies } from './constants.js';
+/** `'error'` or `'unspecified'`; see `UnresolvedPolicies`. */
 export type TUnresolvedPolicy = TConstValue<typeof UnresolvedPolicies>;
+/** The options of the `buildInfoFile` plugin. */
 export interface IBuildInfoFileOptions {
-    /** The app folder, where its package.json is. Default: the folder Vite runs in. */
+    /**
+     * The app folder, where its package.json is.
+     * @default process.cwd()
+     */
     root?: string;
-    /** The file's path under the output folder and under the dev server's base. Default: `build-info.json`. */
+    /**
+     * The file's path under the output folder and under the dev server's base.
+     * A relative path of letters, digits, `.`, `_` and `-`, with `/` between folders, ending `.json`, and
+     * no `..` segment; anything else throws.
+     * @default 'build-info.json'
+     */
     fileName?: string;
-    /** Dependencies whose name starts with this are listed under `frameworks`. Default: `@venizia/`. */
+    /**
+     * Dependencies whose name starts with this are listed under `frameworks`.
+     * @default '@venizia/'
+     */
     frameworkScope?: string;
-    /** What a build does when no commit can be found: `error` (default) or `unspecified`. The dev server always serves what it has and warns. */
+    /**
+     * What a build does when no commit can be found: `error` or `unspecified`. The dev server always serves what it has and warns.
+     * @default UnresolvedPolicies.ERROR
+     */
     onUnresolved?: TUnresolvedPolicy;
 }
 export type TGitReadResult = {

package/dist/vite/plugin.d.ts

@@ -15,6 +15,16 @@ export declare const createBuildInfoFilePlugin: (opts: {
  * Emits `build-info.json` into the build and serves it on the dev server: the commit, the branch and
  * the build time from the pipeline or git, the app's name and version, and the installed versions of
  * the framework packages it depends on. The shape is `IBuildInfoFile` of `@venizia/ardor`.
+ *
+ * @example
+ * ```ts
+ * import { buildInfoFile } from '@venizia/ardor/vite';
+ * import { defineConfig } from 'vite';
+ *
+ * export default defineConfig({
+ *   plugins: [buildInfoFile({ fileName: 'build-info.json', onUnresolved: 'unspecified' })],
+ * });
+ * ```
  */
 export declare const buildInfoFile: (opts?: IBuildInfoFileOptions) => Plugin;
 export {};

package/dist/vite/plugin.js

@@ -104,6 +104,16 @@ export const createBuildInfoFilePlugin = (opts) => {
  * Emits `build-info.json` into the build and serves it on the dev server: the commit, the branch and
  * the build time from the pipeline or git, the app's name and version, and the installed versions of
  * the framework packages it depends on. The shape is `IBuildInfoFile` of `@venizia/ardor`.
+ *
+ * @example
+ * ```ts
+ * import { buildInfoFile } from '@venizia/ardor/vite';
+ * import { defineConfig } from 'vite';
+ *
+ * export default defineConfig({
+ *   plugins: [buildInfoFile({ fileName: 'build-info.json', onUnresolved: 'unspecified' })],
+ * });
+ * ```
  */
 export const buildInfoFile = (opts = {}) => createBuildInfoFilePlugin({ options: opts, sources: defaultSources });
 //# sourceMappingURL=plugin.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ardor",
-  "version": "0.4.8-1",
+  "version": "0.4.8-3",
   "description": "ARDOR - frontend application framework for the VENIZIA family. One entry point over ardor-kernel, ardor-react and ardor-admin: IGNIS inversion of control, a REST data layer, auth and i18n providers, and the React bindings for a react-admin application.",
   "keywords": [
     "ardor",
@@ -79,21 +79,21 @@
     "prepublishOnly": "make rebuild"
   },
   "dependencies": {
-    "@venizia/ardor-admin": "0.4.8-1",
-    "@venizia/ardor-kernel": "0.4.8-1",
-    "@venizia/ardor-react": "0.4.8-1"
+    "@venizia/ardor-admin": "0.4.8-3",
+    "@venizia/ardor-kernel": "0.4.8-3",
+    "@venizia/ardor-react": "0.4.8-3"
   },
   "devDependencies": {
     "@size-limit/preset-small-lib": "^14.2.0",
     "@types/bun": "^1.4.3",
     "@types/node": "^25.0.10",
-    "@venizia/dev-configs": "^0.4.8-0",
-    "@venizia/ignis-boot": "^0.4.8-0",
-    "@venizia/ignis-connectors": "^0.4.8-0",
-    "@venizia/ignis-filter": "^0.4.7-0",
-    "@venizia/ignis-helpers": "^0.4.8-0",
-    "@venizia/ignis-inversion": "^0.4.7-0",
-    "@venizia/ignis-kernel": "^0.4.8-0",
+    "@venizia/dev-configs": "^0.4.8-2",
+    "@venizia/ignis-boot": "^0.4.8-2",
+    "@venizia/ignis-connectors": "^0.4.8-2",
+    "@venizia/ignis-filter": "^0.4.7-2",
+    "@venizia/ignis-helpers": "^0.4.8-2",
+    "@venizia/ignis-inversion": "^0.4.7-2",
+    "@venizia/ignis-kernel": "^0.4.8-2",
     "eslint": "^10.13.0",
     "oxlint": "1.89.0",
     "oxlint-tsgolint": "7.0.2004",
@@ -105,12 +105,12 @@
   "peerDependencies": {
     "@reduxjs/toolkit": ">=2.13.0",
     "@tanstack/react-query": ">=5.104.5",
-    "@venizia/ignis-boot": "^0.4.8-0",
-    "@venizia/ignis-connectors": "^0.4.8-0",
-    "@venizia/ignis-filter": "^0.4.7-0",
-    "@venizia/ignis-helpers": "^0.4.8-0",
-    "@venizia/ignis-inversion": "^0.4.7-0",
-    "@venizia/ignis-kernel": "^0.4.8-0",
+    "@venizia/ignis-boot": "^0.4.8-2",
+    "@venizia/ignis-connectors": "^0.4.8-2",
+    "@venizia/ignis-filter": "^0.4.7-2",
+    "@venizia/ignis-helpers": "^0.4.8-2",
+    "@venizia/ignis-inversion": "^0.4.7-2",
+    "@venizia/ignis-kernel": "^0.4.8-2",
     "ra-core": ">=5.15.5",
     "ra-i18n-polyglot": ">=5.15.5",
     "react": ">=19.3.1",