@nan0web/ui 1.12.1 → 1.12.3

package/types/domain/app/GalleryRenderCommand.d.ts

@@ -0,0 +1,27 @@
+export class GalleryRenderCommand extends ModelAsApp {
+    static alias: string;
+    static UI: {
+        rendering: string;
+        success: string;
+        failed: string;
+    };
+    static dataDir: {
+        type: string;
+        default: string;
+        help: string;
+    };
+    static dir: {
+        type: string;
+        default: string;
+        help: string;
+    };
+    /**
+     * @param {Partial<GalleryRenderCommand> | Record<string, any>} [data={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+     */
+    constructor(data?: Partial<GalleryRenderCommand> | Record<string, any>, options?: Partial<import("@nan0web/types").ModelOptions>);
+    /** @type {string} */ dataDir: string;
+    /** @type {string} */ dir: string;
+}
+export default GalleryRenderCommand;
+import { ModelAsApp } from '../index.js';

package/types/domain/app/SnapshotAuditor.d.ts

@@ -1,25 +1,34 @@
 /**
  * SnapshotAuditor — Zero-Hallucination Snapshot Validation (Model-as-Schema v2).
  * Parses snapshots without evaluating the app logic and detects artifacts.
- *
- * @extends {AuditorModel}
  */
-export class SnapshotAuditor {
+export class SnapshotAuditor extends AuditorModel {
     static alias: string;
-    static dir: {
-        type: string;
-        help: string;
-        positional: boolean;
-        default: string;
-    };
     static data: {
         type: string;
         help: string;
         default: string;
     };
-    /** @type {Object<string, string>} Messages for UI */
     static UI: {
-        [x: string]: string;
+        title: string;
+        description: string;
+        icon: string;
+        starting: string;
+        noSnapshots: string;
+        doneSuccess: string;
+        doneErrors: string;
+        auditPassed: string;
+        auditFailed: string;
+        errorDb: string;
+        errorGlitch: string;
+        errorShort: string;
+        errorSyntax: string;
+        errorArtifact: string;
+        errorRouting: string;
+        errorUntranslated: string;
+        errorEnglishLeak: string;
+        errorEmptyRender: string;
+        errorForeignLeak: string;
     };
     /** @type {string[]} Common UI components that can be empty in render */
     static EXEMPT_EMPTY: string[];
@@ -31,6 +40,14 @@ export class SnapshotAuditor {
     static SUSPICIOUS_FILENAME: RegExp;
     /** @type {number} Minimum filename length */
     static MIN_FILENAME_LENGTH: number;
+    /** @type {string[]} Directories to ignore during scanning */
+    static IGNORE_DIRS: string[];
+    /**
+     * Checks if a directory or file should be ignored.
+     * @param {string} name
+     * @returns {boolean}
+     */
+    static isIgnored(name: string): boolean;
     /**
      * Extracts all valid words from an object into a Set.
      * @param {any} obj Node to extract from.
@@ -39,11 +56,11 @@ export class SnapshotAuditor {
     static extractWords(obj: any, set: Set<string>): void;
     /**
      * Scans data directories to build a word set for each language.
-     * @param {any} fsDb FileSystem DB.
+     * @param {import('@nan0web/db').DB} fsDb FileSystem DB.
      * @param {string} data
      * @returns {Promise<Record<string, Set<string>>>}
      */
-    static buildDictionaries(fsDb: any, data?: string): Promise<Record<string, Set<string>>>;
+    static buildDictionaries(fsDb: import("@nan0web/db").DB, data?: string): Promise<Record<string, Set<string>>>;
     /**
      * Inspects a single snapshot text.
      * @param {string} content Content of the file.
@@ -83,17 +100,10 @@ export class SnapshotAuditor {
     }): void;
     /**
      * @param {Partial<SnapshotAuditor> | Record<string, any>} [data={}]
-     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+     * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options={}]
      */
-    constructor(data?: Partial<SnapshotAuditor> | Record<string, any>, options?: Partial<import("@nan0web/types").ModelOptions>);
-    /** @type {import('@nan0web/types').ModelOptions} */
-    options: import("@nan0web/types").ModelOptions;
-    /** @type {string} Target directory to audit */ dir: string;
+    constructor(data?: Partial<SnapshotAuditor> | Record<string, any>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
     /** @type {string} Directory to scan for dictionaries */ data: string;
-    /**
-     * Run the snapshot audit inside the target directory.
-     * @returns {AsyncGenerator<import('@nan0web/ui').Intent, any, any>}
-     */
-    run(): AsyncGenerator<import("@nan0web/ui").Intent, any, any>;
 }
 export default SnapshotAuditor;
+import { AuditorModel } from '@nan0web/inspect/domain/AuditorModel';

package/types/domain/app/SnapshotRunner.d.ts

@@ -26,9 +26,9 @@ export class SnapshotRunner extends Model {
     };
     /**
      * @param {Partial<SnapshotRunner> | Record<string, any>} [data={}]
-     * @param {import('@nan0web/types').ModelOptions} [options={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
      */
-    constructor(data?: Partial<SnapshotRunner> | Record<string, any>, options?: import("@nan0web/types").ModelOptions);
+    constructor(data?: Partial<SnapshotRunner> | Record<string, any>, options?: Partial<import("@nan0web/types").ModelOptions>);
     /** @type {string} Directory containing snapshots */ snapshotsDir: string;
     /** @type {string} Root data directory */ data: string;
     /** @type {(compName: string) => string} */ getCategory: (compName: string) => string;

package/types/domain/app/UIApp.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @property {string[]} _positionals
+ * @property {string} command Type of command to run
+ * @property {boolean} help Show help message
+ */
 export class UIApp extends ModelAsApp {
     static command: {
         type: string;
@@ -10,19 +15,12 @@ export class UIApp extends ModelAsApp {
         helpText: string;
         unknownCommand: string;
     };
-    static help: {
-        help: string;
-        default: boolean;
-    };
     /**
      * @param {Partial<UIApp> | Record<string, any>} [data={}]
-     * @param {import('@nan0web/types').ModelOptions} [options={}]
+     * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
      */
-    constructor(data?: Partial<UIApp> | Record<string, any>, options?: import("@nan0web/types").ModelOptions);
-    /** @type {string[]} */ _positionals: string[];
-    /** @type {string} Type of command to run */ command: string;
-    /** @type {boolean} Show help message */ help: boolean;
-    run(): AsyncGenerator<import("../../core/Intent.js").ShowIntent | import("../../core/Intent.js").RenderIntent | (import("../../core/Intent.js").AskIntent & {
+    constructor(data?: Partial<UIApp> | Record<string, any>, options?: Partial<import("@nan0web/types").ModelOptions>);
+    run(): AsyncGenerator<import("../../core/Intent.js").ShowIntent | (import("../../core/Intent.js").AskIntent & {
         $value?: any;
         $success?: boolean;
         $files?: Record<string, string>;
@@ -37,6 +35,11 @@ export class UIApp extends ModelAsApp {
         $success?: boolean;
         $files?: Record<string, string>;
         $message?: string;
+    }) | (import("../../core/Intent.js").RenderIntent & {
+        $value?: any;
+        $success?: boolean;
+        $files?: Record<string, string>;
+        $message?: string;
     }) | (import("../../core/Intent.js").AgentIntent & {
         $value?: any;
         $success?: boolean;
@@ -47,7 +50,7 @@ export class UIApp extends ModelAsApp {
         $success?: boolean;
         $files?: Record<string, string>;
         $message?: string;
-    }), any, any>;
+    }), import("../../core/Intent.js").ResultIntent, any>;
 }
 export default UIApp;
 import { ModelAsApp } from '../ModelAsApp.js';

package/types/index.d.ts

@@ -9,6 +9,7 @@ export { default as UiForm } from "./core/Form/Form.js";
 export { default as UiMessage } from "./core/Message/Message.js";
 export { default as UiStream } from "./core/Stream.js";
 export { default as UiAdapter } from "./core/UiAdapter.js";
+export { resolvePositionalArgs } from "./core/resolvePositionalArgs.js";
 export * from "./core/Intent.js";
 export * from "./domain/index.js";
 export { IntentErrorModel } from "./core/IntentErrorModel.js";
@@ -39,8 +40,9 @@ import StdIn from './StdIn.js';
 import StdOut from './StdOut.js';
 import View from './View/View.js';
 import RenderOptions from './View/RenderOptions.js';
-import Model from './Model/index.js';
+import { Model } from '@nan0web/types';
+import Models from './Model/index.js';
 import Component from './Component/index.js';
 import App from './App/index.js';
-export { Frame, FrameProps, Locale, StdIn, StdOut, View, RenderOptions, Model, Component, App };
+export { Frame, FrameProps, Locale, StdIn, StdOut, View, RenderOptions, Model, Models, Component, App };
 export { default as Error, CancelError } from "./core/Error/index.js";

package/types/inspect.d.ts

@@ -1,2 +1,3 @@
 export * from "./testing/SnapshotRunner.js";
 export * from "./testing/verifySnapshot.js";
+export { SnapshotAuditor } from "./domain/app/SnapshotAuditor.js";

package/types/testing/SpecRunner.d.ts

@@ -16,6 +16,28 @@ export class SpecRunner extends ModelAsApp {
         running: string;
         unhandledSteps: string;
     };
+    /**
+     * Convenience method to load a .nan0 file and run a specific scenario.
+     *
+     * 💡 Note on Expectations:
+     * You do NOT need to write manual assertions when using this method.
+     * The `for await (const _ of runner.run()) {}` loop drives the generator,
+     * but ALL assertions are handled automatically inside `SpecAdapter.js`.
+     *
+     * Whenever the App yields an intent (`ask`, `show`, `result`), `SpecAdapter`
+     * intercepts it and compares it strictly against the next step in the `.nan0` file.
+     * - If it matches, the test continues (and `$value` is injected back into the App).
+     * - If it mismatches, it throws an `assert.fail()` which fails the Node.js test immediately.
+     * - If the App finishes early, it throws an `unhandledSteps` error.
+     *
+     * @param {string} fileDir The directory containing the file (e.g., import.meta.dirname)
+     * @param {string} fileName The name of the .nan0 file
+     * @param {string} scenarioName The name of the scenario to run
+     * @param {Record<string, any>} registry The Model Class registry
+     * @param {Partial<import('../index.js').ModelAsAppOptions>} [options={}] Additional runner context options
+     * @throws {Error} If the scenario is missing or if expectations fail during execution
+     */
+    static executeFile(fileDir: string, fileName: string, scenarioName: string, registry: Record<string, any>, options?: Partial<import("../index.js").ModelAsAppOptions>): Promise<void>;
     /**
      * Run a Nan0Spec sequence programmatically (for unit tests).
      *

package/types/testing/verifySnapshot.d.ts

@@ -10,5 +10,5 @@ export function verifySnapshot({ name, data, fs, path }: {
     name: string;
     data: Array<any>;
     fs?: typeof import("node:fs/promises") | undefined;
-    path?: import("path").PlatformPath | undefined;
+    path?: typeof import("node:path") | undefined;
 }): Promise<void>;

package/types/domain/app/GalleryRenderIntent.d.ts

@@ -1,31 +0,0 @@
-export class GalleryRenderIntent extends Model {
-    static alias: string;
-    static UI: {
-        rendering: string;
-        success: string;
-        failed: string;
-    };
-    static dataDir: {
-        type: string;
-        default: string;
-        help: string;
-    };
-    static dir: {
-        type: string;
-        default: string;
-        help: string;
-    };
-    /**
-
-     * @param {Partial<GalleryRenderIntent> | Record<string, any>} [data={}]
-
-     * @param {import('@nan0web/types').ModelOptions} [options={}]
-
-     */
-    constructor(data?: Partial<GalleryRenderIntent> | Record<string, any>, options?: import("@nan0web/types").ModelOptions);
-    /** @type {string} */ dataDir: string;
-    /** @type {string} */ dir: string;
-    run(): AsyncGenerator<import("../../core/Intent.js").ShowIntent, import("../../core/Intent.js").ResultIntent | undefined, unknown>;
-}
-export default GalleryRenderIntent;
-import { Model } from '@nan0web/types';