@nan0web/ui 1.11.0 → 1.12.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nan0web/ui",
-  "version": "1.11.0",
+  "version": "1.12.1",
   "description": "NaN•Web UI. One application logic (algorithm) and many UI.",
   "main": "src/index.js",
   "types": "types/index.d.ts",
@@ -24,6 +24,10 @@
       "import": "./src/core/index.js",
       "types": "./types/core/index.d.ts"
     },
+    "./src/core/Intent.js": {
+      "import": "./src/core/Intent.js",
+      "types": "./types/core/Intent.d.ts"
+    },
     "./domain": {
       "import": "./src/domain/index.js",
       "types": "./types/domain/index.d.ts"
@@ -70,23 +74,23 @@
     "lit": "^3.3.2",
     "vite": "^6.4.1",
     "vitest": "^3.2.4",
-    "@nan0web/db-fs": "1.2.1",
+    "@nan0web/db-fs": "1.2.2",
     "@nan0web/event": "1.0.1",
     "@nan0web/i18n": "1.5.0",
-    "@nan0web/inspect": "1.0.0",
-    "@nan0web/ui-cli": "2.12.3",
-    "@nan0web/test": "1.1.4",
     "@nan0web/icons": "1.1.0",
-    "@nan0web/release": "1.0.3",
+    "@nan0web/inspect": "1.0.0",
+    "@nan0web/ui-cli": "2.13.1",
     "@nan0web/nan0web.app": "0.1.0",
-    "@nan0web/ui-lit": "1.1.0"
+    "@nan0web/ui-lit": "1.1.0",
+    "@nan0web/test": "1.1.4",
+    "@nan0web/release": "1.0.3"
   },
   "dependencies": {
     "string-width": "^7.2.0",
     "@nan0web/co": "2.0.1",
+    "@nan0web/core": "1.1.3",
     "@nan0web/log": "1.1.1",
-    "@nan0web/types": "1.7.2",
-    "@nan0web/core": "1.1.3"
+    "@nan0web/types": "1.7.3"
   },
   "scripts": {
     "prebuild": "rm -rf types/",

package/src/App/Core/CoreApp.js

@@ -15,7 +15,7 @@ export default class CoreApp {
 	/** @type {Map<string, CommandFn>} Registered command handlers */
 	commands
 
-	/** @type {object} App state */
+	/** @type {Record<string, any>} App state */
 	state
 
 	/** @type {Message} Starting command parsed from argv */

package/src/View/View.js

@@ -28,7 +28,7 @@ export default class View {
 	frame
 	/** @type {Locale} */
 	locale
-	/** @type {Map} */
+	/** @type {Map<string, string>} */
 	vocab
 	/** @type {number[]} */
 	windowSize
@@ -43,7 +43,7 @@ export default class View {
 	 * @param {number} [input.startedAt]
 	 * @param {Frame} [input.frame]
 	 * @param {Locale} [input.locale]
-	 * @param {Map} [input.vocab]
+	 * @param {Map<string, string>} [input.vocab]
 	 * @param {number[]} [input.windowSize]
 	 * @param {Map<string, ComponentFn>} [input.components]
 	 * @param {string} [input.renderMethod]
@@ -66,7 +66,7 @@ export default class View {
 		this.frame = frame
 		this.locale = locale
 		this.vocab = vocab
-		this.windowSize = null === windowSize ? this.stdout.getWindowSize() : windowSize
+		this.windowSize = /** @type {number[]} */ (null === windowSize ? this.stdout.getWindowSize() : windowSize)
 		this.components = components
 		this.renderMethod = renderMethod
 		if (!empty(frame)) {
@@ -85,6 +85,10 @@ export default class View {
 	getWindowSize() {
 		return equal(this.windowSize, [0, 0]) ? this.stdout.getWindowSize() : this.windowSize
 	}
+	/**
+	 * @param {number} width
+	 * @param {number} height
+	 */
 	setWindowSize(width, height) {
 		this.windowSize = [width, height]
 	}
@@ -181,6 +185,7 @@ export default class View {
 		}
 	}
 
+	/** @param {any} value */
 	t(value) {
 		if (typeOf(Array)(value)) {
 			value = value.map((row) => {
@@ -196,16 +201,22 @@ export default class View {
 		return this.vocab.has(value) ? this.vocab.get(value) : value
 	}
 
+	/** @param {any[]} args */
 	debug(...args) {
+		// @ts-ignore
 		return this.render(1)([StdOut.STYLES.dim, 'Debug: ', args.join(' '), Frame.EOL, StdOut.RESET])
 	}
 
+	/** @param {any[]} args */
 	info(...args) {
+		// @ts-ignore
 		return this.render(1)([StdOut.COLORS.green, 'Info : ', args.join(' '), Frame.EOL, StdOut.RESET])
 	}
 
+	/** @param {any[]} args */
 	warn(...args) {
 		return this.render(1)([
+			// @ts-ignore
 			StdOut.COLORS.yellow,
 			'Warn : ',
 			args.join(' '),
@@ -214,8 +225,10 @@ export default class View {
 		])
 	}
 
+	/** @param {any[]} args */
 	error(...args) {
 		return this.render(1)([
+			// @ts-ignore
 			StdOut.COLORS.red,
 			StdOut.STYLES.bold,
 			'Error: ',

package/src/core/InputAdapter.js

@@ -2,6 +2,18 @@ import Event from '@nan0web/event/oop'
 import CancelError from './Error/CancelError.js'
 import UiMessage from './Message/Message.js'
 
+/**
+ * @typedef {Object} AskOptions
+ * @property {boolean} [silent] - Suppress logs or output.
+ * @property {string} [title] - Custom title for the prompt.
+ * @property {string} [hint] - Presentation hint (e.g., 'password', 'tree', 'markdown').
+ * @property {any} [default] - Default value if no input is provided.
+ * @property {Array<string|Object>} [options] - Array of options for select inputs.
+ * @property {Record<string, any>} [UI] - Localization dictionary/overrides.
+ * @property {string} [component] - Target specific component override.
+ */
+/** @typedef {import('./index.js').AskResponse} AskResponse */
+
 /**
  * Abstract input adapter for UI implementations.
  *
@@ -41,19 +53,22 @@ export class InputAdapter extends Event {
 		return true
 	}
 
+
+
 	/**
 	 * Helper to ask a question.
-	 * @param {string} question - Question to ask.
-	 * @returns {Promise<string>}
+	 * @param {string|import('./Message/Message.js').default|any} question - Question to ask, Form instance, or AskIntent.
+	 * @param {AskOptions} [options] - Additional options.
+	 * @returns {Promise<AskResponse>}
 	 */
-	async ask(question) {
+	async ask(question, options) {
 		throw new Error('ask() method must be implemented in subclass')
 	}
 
 	/**
 	 * Generic selection prompt.
 	 * @param {Object} config - Selection configuration.
-	 * @returns {Promise<{ index: number, value: string | null }>}
+	 * @returns {Promise<{ index?: number, value: string | null }>}
 	 */
 	async select(config) {
 		throw new Error('select() method must be implemented in subclass')

package/src/core/Intent.js

@@ -41,6 +41,7 @@ import { IntentErrorModel } from './IntentErrorModel.js'
  * @property {number} [total] - Absolute total (if value is absolute).
  * @property {string} [id] - Progress ID for tracking by Adapter to calculate speed/eta.
  * @property {string} message - Status message from Model (i18n static field value).
+ * @property {ProgressOptions} [options] - Additional options for progress intent.
  */
 
 /**
@@ -71,6 +72,7 @@ import { IntentErrorModel } from './IntentErrorModel.js'
  * @typedef {Object} ResultIntent
  * @property {'result'} type
  * @property {*} data - The raw result data (JSON-serializable).
+ * @property {boolean} [raw] - If true, Adapter MUST output data raw (no UI decorations).
  */
 
 /**
@@ -118,7 +120,11 @@ import { IntentErrorModel } from './IntentErrorModel.js'
  * The value MUST conform to the type described in the requested FieldSchema.
  * @typedef {Object} AskResponse
  * @property {*} value - The value matching schema.type (collected from user / LLM / test fixture).
- * @property {boolean} [cancelled] - Whether the user cancelled this interaction (e.g. pressed ESC).
+ * @property {boolean} cancelled - Whether the user cancelled this interaction (e.g. pressed ESC).
+ * @property {string} [action] - The action identifier (e.g., 'submit', 'exit', 'back').
+ * @property {any} [body] - Additional payload or form data.
+ * @property {any} [form] - The form model instance (if applicable).
+ * @property {number} [index] - The selected index for lists/tables.
  */
 
 /**
@@ -244,26 +250,50 @@ export function ask(field, schema) {
 	return { type: 'ask', field, schema }
 }
 
+/**
+ * @typedef {Object} ProgressOptions
+ * @property {number} [total] - Absolute total steps.
+ * @property {string} [id] - Progress tracking ID.
+ * @property {number} [width] - Width of the progress bar in terminal characters.
+ * @property {number} [fps] - Frames per second update rate limit.
+ * @property {string} [format] - Custom format string (e.g. '{time} {bar} {percent} {title}').
+ * @property {number} [columns] - Number of columns (terminal width).
+ * @property {boolean} [forceOneLine] - Prevent wrapping and truncate instead.
+ * @property {boolean|'success'|'error'} [stop] - Set to true to stop, or 'success'/'error' to stop with a status icon (for spinners).
+ */
+
 /**
  * Create a progress intent.
  * @param {string} message - Status message from Model (i18n static field value).
  * @param {number} [value=0] - Progress value (current step or percentage).
- * @param {number|string} [totalOrId] - Absolute total steps (number) OR progress tracking ID (string).
+ * @param {ProgressOptions|number|string} [optionsOrTotalOrId] - Options object, or absolute total steps (number), or progress tracking ID (string).
  * @param {string} [id='default'] - Progress ID (if total is provided).
  * @returns {ProgressIntent}
  */
-export function progress(message, value = 0, totalOrId, id) {
-	let total = undefined
-	let progressId = 'default'
-
-	if (typeof totalOrId === 'number') {
-		total = totalOrId
-		if (typeof id === 'string') progressId = id
-	} else if (typeof totalOrId === 'string') {
-		progressId = totalOrId
+export function progress(message, value = 0, optionsOrTotalOrId, id) {
+	/** @type {ProgressOptions} */
+	let options = {}
+
+	if (typeof optionsOrTotalOrId === 'object' && optionsOrTotalOrId !== null) {
+		options = optionsOrTotalOrId
+	} else {
+		// legacy support
+		if (typeof optionsOrTotalOrId === 'number') {
+			options.total = optionsOrTotalOrId
+			if (typeof id === 'string') options.id = id
+		} else if (typeof optionsOrTotalOrId === 'string') {
+			options.id = optionsOrTotalOrId
+		}
 	}
 
-	return { type: 'progress', message, value, total, id: progressId }
+	return { 
+		type: 'progress', 
+		message, 
+		value, 
+		total: options.total,
+		id: options.id || 'default', 
+		options 
+	}
 }
 
 export function log(level, message, data = {}) {
@@ -283,10 +313,11 @@ export function render(component, props = {}) {
 /**
  * Create a result intent.
  * @param {*} data - The raw result data.
+ * @param {boolean} [raw=false] - If true, result is printed raw.
  * @returns {ResultIntent}
  */
-export function result(data) {
-	return { type: 'result', data }
+export function result(data, raw = false) {
+	return { type: 'result', data, raw }
 }
 
 /**

package/src/core/index.js

@@ -42,6 +42,9 @@ export { default as Flow } from './Flow.js'
 
 // OLMUI Generator Engine — Intent-based Model→Adapter contract
 export { validateIntent, ask, progress, log, render, result, INTENT_TYPES, isModelSchema } from './Intent.js'
+/** @typedef {import('./Intent.js').Intent} Intent */
+/** @typedef {import('./Intent.js').AskResponse} AskResponse */
+/** @typedef {import('./InputAdapter.js').AskOptions} AskOptions */
 export { IntentErrorModel } from './IntentErrorModel.js'
 export { runGenerator } from './GeneratorRunner.js'
 

package/src/domain/Content.js

@@ -37,7 +37,7 @@ import { Model } from '@nan0web/types'
  * @property {string|ContentData[]} [fieldset]
  * @property {string|ContentData[]} [figcaption]
  * @property {string|ContentData[]} [figure]
- * @property {string|ContentData[]} [footer]
+ * @property {any} [footer]
  * @property {string|ContentData[]} [form]
  * @property {string|ContentData[]} [h1]
  * @property {string|ContentData[]} [h2]
@@ -46,7 +46,7 @@ import { Model } from '@nan0web/types'
  * @property {string|ContentData[]} [h5]
  * @property {string|ContentData[]} [h6]
  * @property {string|ContentData[]} [head]
- * @property {string|ContentData[]} [header]
+ * @property {any} [header]
  * @property {string|ContentData[]} [hgroup]
  * @property {boolean|object} [hr]
  * @property {string|ContentData[]} [html]
@@ -139,6 +139,8 @@ import { Model } from '@nan0web/types'
  * @property {import('./components/FAQModel.js').FAQModel} [faq]
  * @property {import('./components/FeatureGridModel.js').FeatureGridModel} [featureGrid]
  * @property {import('./components/GalleryModel.js').GalleryModel} [gallery]
+ * @property {import('./HeaderModel.js').HeaderModel} [header]
+ * @property {import('./FooterModel.js').FooterModel} [footer]
  * @property {import('./components/InputModel.js').InputModel} [input]
  * @property {import('./components/MarkdownModel.js').MarkdownModel} [markdown]
  * @property {import('./components/PriceModel.js').PriceModel} [price]

package/src/domain/Document.js

@@ -1,9 +1,14 @@
 import { Model } from '@nan0web/types'
 import { Content } from './Content.js'
+import Navigation from './Navigation.js'
+import { Language } from '@nan0web/i18n'
 
 export class Document extends Model {
 	static title = { type: 'string', help: 'Title' }
 	static content = { type: 'array', model: Content, help: 'Content' }
+	static $content = { type: 'array', model: Content, help: 'Layout configuration' }
+	static nav = { type: 'any', model: Navigation, help: 'Navigation config or reference' }
+	static langs = { type: 'array', model: Language, help: 'Supported languages array' }
 	/**
 	 *
 	 * @param {Partial<Document>} [data]
@@ -13,5 +18,8 @@ export class Document extends Model {
 		super(data, options)
 		/** @type {string} Title */ this.title
 		/** @type {Array<Content>} Content */ this.content
+		/** @type {Array<Content>} Layout configuration */ this.$content
+		/** @type {Navigation|string|Array<Navigation>} Navigation config */ this.nav
+		/** @type {Array<Language>} Supported languages */ this.langs
 	}
 }

package/src/domain/ModelAsApp.js

@@ -16,7 +16,7 @@ export class ModelAsApp extends Model {
 	}
 	/**
 	 * @param {Partial<ModelAsApp> | Record<string, any>} [data={}]
-	 * @param {ModelAsAppOptions} [options={}]
+	 * @param {Partial<ModelAsAppOptions>} [options={}]
 	 */
 	constructor(data = {}, options = {}) {
 		super(data, options)

package/src/domain/app/ConfigApp.js

@@ -0,0 +1,61 @@
+import { ModelAsApp } from '../ModelAsApp.js'
+import { show, result, render } from '../../core/Intent.js'
+
+export default class ConfigApp extends ModelAsApp {
+	static name = 'config'
+	static alias = 'cfg'
+
+	static resource = {
+		type: 'string',
+		help: 'Resource to configure (e.g. agents)',
+		positional: true,
+		default: 'agents',
+	}
+
+	static action = {
+		type: 'string',
+		help: 'Action to perform (e.g. list)',
+		positional: true,
+		default: 'list',
+	}
+
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		this.resource = data.resource || 'agents'
+		this.action = data.action || 'list'
+	}
+
+	async *run() {
+		if (this.resource === 'agents') {
+			if (this.action === 'list') {
+				const DBFS = (await import('@nan0web/db-fs')).default
+				const db = new DBFS({ root: process.cwd() })
+				const config = await db.loadDocument('nan0web.nan0', {}).catch(() => ({}))
+
+				if (!config || !config.agents || !Array.isArray(config.agents)) {
+					yield show('No agents configured in nan0web.nan0')
+					return result({ success: true })
+				}
+
+				const tableData = config.agents.map((a) => ({
+					ID: a.id,
+					Description: a.description,
+					Workflows: a.workflows ? a.workflows.length : 0,
+					Inspectors: a.inspectors ? a.inspectors.length : 0,
+				}))
+
+				yield render('Table', { 
+					data: tableData, 
+					columns: ['ID', 'Description', 'Workflows', 'Inspectors'],
+					interactive: false 
+				})
+				return result({ success: true })
+			}
+			yield show(`Unknown action for agents: ${this.action}`, 'error')
+			return result({ success: false })
+		}
+
+		yield show(`Unknown config resource: ${this.resource}`, 'error')
+		return result({ success: false })
+	}
+}

package/src/domain/app/SnapshotAuditor.js

@@ -64,16 +64,14 @@ export class SnapshotAuditor extends AuditorModel {
 	/** @type {number} Minimum filename length */
 	static MIN_FILENAME_LENGTH = 3
 
-	/** @type {import('../../index.js').ModelAsAppOptions} */
-	_
-
 	/**
 	 * @param {Partial<SnapshotAuditor> | Record<string, any>} [data={}]
 	 * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
 	 */
 	constructor(data = {}, options = {}) {
 		super(data, options)
-		this._ = options
+		/** @type {import('@nan0web/types').ModelOptions} */
+		this.options = options
 		/** @type {string} Target directory to audit */ this.dir
 		/** @type {string} Directory to scan for dictionaries */ this.data
 	}
@@ -160,7 +158,7 @@ export class SnapshotAuditor extends AuditorModel {
 	 * @returns {AsyncGenerator<import('@nan0web/ui').Intent, any, any>}
 	 */
 	async *run() {
-		const { t } = this._
+		const { t } = this.options
 		const snapshotsDir = this.dir || '.'
 
 		yield show(t(SnapshotAuditor.UI.starting, { dir: snapshotsDir }))
@@ -168,7 +166,7 @@ export class SnapshotAuditor extends AuditorModel {
 		const files = []
 
 		/** @type {import('@nan0web/db').DB} */
-		let fsDb = this._.db
+		let fsDb = this.options.db
 		if (fsDb && fsDb.mounts && fsDb.mounts.has('')) {
 			fsDb = /** @type {import('@nan0web/db').DB} */ (fsDb.mounts.get(''))
 		}

package/src/domain/app/UIApp.js

@@ -2,13 +2,14 @@ import { ModelAsApp } from '../ModelAsApp.js'
 import { resolvePositionalArgs } from '@nan0web/ui-cli'
 import SnapshotAuditor from './SnapshotAuditor.js'
 import GalleryCommand from './GalleryCommand.js'
+import ConfigApp from './ConfigApp.js'
 import { show, result } from '../../core/Intent.js'
 
 export class UIApp extends ModelAsApp {
 	static command = {
 		type: 'string',
 		help: 'Command to run (e.g. gallery)',
-		options: [GalleryCommand, SnapshotAuditor],
+		options: [GalleryCommand, SnapshotAuditor, ConfigApp],
 		default: GalleryCommand.alias || GalleryCommand.name,
 		positional: true,
 	}

package/src/index.js

@@ -33,6 +33,7 @@ export { default as UiAdapter } from './core/UiAdapter.js'
 /** @typedef {import('./core/Intent.js').IntentResponse} IntentResponse */
 /** @typedef {import('./core/Intent.js').AskIntent} AskIntent */
 /** @typedef {import('./core/Intent.js').ProgressIntent} ProgressIntent */
+/** @typedef {import('./core/Intent.js').ProgressOptions} ProgressOptions */
 /** @typedef {import('./core/Intent.js').LogIntent} LogIntent */
 /** @typedef {import('./core/Intent.js').ShowIntent} ShowIntent */
 /** @typedef {import('./core/Intent.js').RenderIntent} RenderIntent */
@@ -41,6 +42,7 @@ export { default as UiAdapter } from './core/UiAdapter.js'
 /** @typedef {import('./core/Intent.js').AskResponse} AskResponse */
 /** @typedef {import('./core/Intent.js').AbortResponse} AbortResponse */
 /** @typedef {import('./core/Intent.js').ShowData} ShowData */
+/** @typedef {import('./core/InputAdapter.js').AskOptions} AskOptions */
 export * from './core/Intent.js'
 
 export { IntentErrorModel } from './core/IntentErrorModel.js'

package/src/test/ScenarioAdapter.js

@@ -34,7 +34,7 @@ export default class ScenarioAdapter extends InputAdapter {
 			return { value: match.value, cancelled: !!match.cancelled }
 		}
 		// If no specific match, try to use the first available answer or default
-		return { value: null }
+		return { value: null, cancelled: false }
 	}
 
 	/** @param {import('../core/Intent.js').ProgressIntent} intent */

package/src/testing/LogicInspector.js

@@ -27,7 +27,7 @@ export class LogicInspector {
                 const value = resolvedInputs[inputIdx++]
                 const entry = { type: 'ask', field: i.field, schema: i.schema, input: value }
                 intents.push(entry)
-                return { value }
+                return { value, cancelled: false }
             },
             /** @param {import('../core/Intent.js').ShowIntent} i */
             show: async (i) => {

package/src/testing/SpecAdapter.js

@@ -43,8 +43,7 @@ export class SpecAdapter {
 	async ask(intent) {
 		const step = this.#popExpected('ask')
 		this.assert.equal(step.ask, intent.field, `Field mismatch on ask. Expected '${step.ask}', got '${intent.field}'`)
-		
-		return { value: step.$value }
+		return { value: step.$value, cancelled: false }
 	}
 
 	/**

package/types/App/Core/CoreApp.d.ts

@@ -20,8 +20,8 @@ export default class CoreApp {
     name: string;
     /** @type {Map<string, CommandFn>} Registered command handlers */
     commands: Map<string, CommandFn>;
-    /** @type {object} App state */
-    state: object;
+    /** @type {Record<string, any>} App state */
+    state: Record<string, any>;
     /** @type {Message} Starting command parsed from argv */
     startCommand: Message;
     /**

package/types/View/View.d.ts

@@ -22,7 +22,7 @@ export default class View {
      * @param {number} [input.startedAt]
      * @param {Frame} [input.frame]
      * @param {Locale} [input.locale]
-     * @param {Map} [input.vocab]
+     * @param {Map<string, string>} [input.vocab]
      * @param {number[]} [input.windowSize]
      * @param {Map<string, ComponentFn>} [input.components]
      * @param {string} [input.renderMethod]
@@ -33,7 +33,7 @@ export default class View {
         startedAt?: number | undefined;
         frame?: Frame | undefined;
         locale?: Locale | undefined;
-        vocab?: Map<any, any> | undefined;
+        vocab?: Map<string, string> | undefined;
         windowSize?: number[] | undefined;
         components?: Map<string, ComponentFn> | undefined;
         renderMethod?: string | undefined;
@@ -48,8 +48,8 @@ export default class View {
     frame: Frame;
     /** @type {Locale} */
     locale: Locale;
-    /** @type {Map} */
-    vocab: Map<any, any>;
+    /** @type {Map<string, string>} */
+    vocab: Map<string, string>;
     /** @type {number[]} */
     windowSize: number[];
     /** @type {Map<string, ComponentFn>} */
@@ -60,7 +60,11 @@ export default class View {
     get RenderMethod(): typeof FrameRenderMethod;
     get RenderOptions(): typeof RenderOptions;
     getWindowSize(): number[];
-    setWindowSize(width: any, height: any): void;
+    /**
+     * @param {number} width
+     * @param {number} height
+     */
+    setWindowSize(width: number, height: number): void;
     startTimer(): void;
     spent(checkpoint?: number): number;
     /**
@@ -71,10 +75,15 @@ export default class View {
     render(shouldRender?: boolean | number | Function | ComponentFn, options?: RenderOptions): (value: Frame | string | string[], ...args: any) => Frame;
     clear(shouldRender?: number): Frame;
     progress(shouldRender?: boolean): (value: any) => Frame;
+    /** @param {any} value */
     t(value: any): any;
+    /** @param {any[]} args */
     debug(...args: any[]): Frame;
+    /** @param {any[]} args */
     info(...args: any[]): Frame;
+    /** @param {any[]} args */
     warn(...args: any[]): Frame;
+    /** @param {any[]} args */
     error(...args: any[]): Frame;
     /**
      * @param {string} name

package/types/core/InputAdapter.d.ts

@@ -1,3 +1,14 @@
+/**
+ * @typedef {Object} AskOptions
+ * @property {boolean} [silent] - Suppress logs or output.
+ * @property {string} [title] - Custom title for the prompt.
+ * @property {string} [hint] - Presentation hint (e.g., 'password', 'tree', 'markdown').
+ * @property {any} [default] - Default value if no input is provided.
+ * @property {Array<string|Object>} [options] - Array of options for select inputs.
+ * @property {Record<string, any>} [UI] - Localization dictionary/overrides.
+ * @property {string} [component] - Target specific component override.
+ */
+/** @typedef {import('./index.js').AskResponse} AskResponse */
 /**
  * Abstract input adapter for UI implementations.
  *
@@ -28,20 +39,52 @@ export class InputAdapter extends Event {
     isReady(): boolean;
     /**
      * Helper to ask a question.
-     * @param {string} question - Question to ask.
-     * @returns {Promise<string>}
+     * @param {string|import('./Message/Message.js').default|any} question - Question to ask, Form instance, or AskIntent.
+     * @param {AskOptions} [options] - Additional options.
+     * @returns {Promise<AskResponse>}
      */
-    ask(question: string): Promise<string>;
+    ask(question: string | import("./Message/Message.js").default | any, options?: AskOptions): Promise<AskResponse>;
     /**
      * Generic selection prompt.
      * @param {Object} config - Selection configuration.
-     * @returns {Promise<{ index: number, value: string | null }>}
+     * @returns {Promise<{ index?: number, value: string | null }>}
      */
     select(config: any): Promise<{
-        index: number;
+        index?: number;
         value: string | null;
     }>;
 }
 export default InputAdapter;
+export type AskOptions = {
+    /**
+     * - Suppress logs or output.
+     */
+    silent?: boolean | undefined;
+    /**
+     * - Custom title for the prompt.
+     */
+    title?: string | undefined;
+    /**
+     * - Presentation hint (e.g., 'password', 'tree', 'markdown').
+     */
+    hint?: string | undefined;
+    /**
+     * - Default value if no input is provided.
+     */
+    default?: any;
+    /**
+     * - Array of options for select inputs.
+     */
+    options?: any[] | undefined;
+    /**
+     * - Localization dictionary/overrides.
+     */
+    UI?: Record<string, any> | undefined;
+    /**
+     * - Target specific component override.
+     */
+    component?: string | undefined;
+};
+export type AskResponse = import("./index.js").AskResponse;
 import Event from '@nan0web/event/oop';
 import CancelError from './Error/CancelError.js';

package/types/core/Intent.d.ts

@@ -24,15 +24,26 @@ export function validateIntent(intent: any): intent is Intent;
  * @returns {AskIntent}
  */
 export function ask(field: string, schema: object | Function): AskIntent;
+/**
+ * @typedef {Object} ProgressOptions
+ * @property {number} [total] - Absolute total steps.
+ * @property {string} [id] - Progress tracking ID.
+ * @property {number} [width] - Width of the progress bar in terminal characters.
+ * @property {number} [fps] - Frames per second update rate limit.
+ * @property {string} [format] - Custom format string (e.g. '{time} {bar} {percent} {title}').
+ * @property {number} [columns] - Number of columns (terminal width).
+ * @property {boolean} [forceOneLine] - Prevent wrapping and truncate instead.
+ * @property {boolean|'success'|'error'} [stop] - Set to true to stop, or 'success'/'error' to stop with a status icon (for spinners).
+ */
 /**
  * Create a progress intent.
  * @param {string} message - Status message from Model (i18n static field value).
  * @param {number} [value=0] - Progress value (current step or percentage).
- * @param {number|string} [totalOrId] - Absolute total steps (number) OR progress tracking ID (string).
+ * @param {ProgressOptions|number|string} [optionsOrTotalOrId] - Options object, or absolute total steps (number), or progress tracking ID (string).
  * @param {string} [id='default'] - Progress ID (if total is provided).
  * @returns {ProgressIntent}
  */
-export function progress(message: string, value?: number, totalOrId?: number | string, id?: string): ProgressIntent;
+export function progress(message: string, value?: number, optionsOrTotalOrId?: ProgressOptions | number | string, id?: string): ProgressIntent;
 export function log(level: any, message: any, data?: {}): {
     type: string;
     level: any;
@@ -48,9 +59,10 @@ export function render(component: string, props?: object): RenderIntent;
 /**
  * Create a result intent.
  * @param {*} data - The raw result data.
+ * @param {boolean} [raw=false] - If true, result is printed raw.
  * @returns {ResultIntent}
  */
-export function result(data: any): ResultIntent;
+export function result(data: any, raw?: boolean): ResultIntent;
 /**
  * @typedef {Object} ShowData
  * @property {any} [component]
@@ -98,6 +110,7 @@ export function agent(task: string, context?: AgentContext): AgentIntent;
  * @property {number} [total] - Absolute total (if value is absolute).
  * @property {string} [id] - Progress ID for tracking by Adapter to calculate speed/eta.
  * @property {string} message - Status message from Model (i18n static field value).
+ * @property {ProgressOptions} [options] - Additional options for progress intent.
  */
 /**
  * @typedef {'info' | 'warn' | 'error' | 'success'} ShowLevel
@@ -123,6 +136,7 @@ export function agent(task: string, context?: AgentContext): AgentIntent;
  * @typedef {Object} ResultIntent
  * @property {'result'} type
  * @property {*} data - The raw result data (JSON-serializable).
+ * @property {boolean} [raw] - If true, Adapter MUST output data raw (no UI decorations).
  */
 /**
  * Model requests rendering of a pure UI component (Header, Footer, Static Map).
@@ -163,7 +177,11 @@ export function agent(task: string, context?: AgentContext): AgentIntent;
  * The value MUST conform to the type described in the requested FieldSchema.
  * @typedef {Object} AskResponse
  * @property {*} value - The value matching schema.type (collected from user / LLM / test fixture).
- * @property {boolean} [cancelled] - Whether the user cancelled this interaction (e.g. pressed ESC).
+ * @property {boolean} cancelled - Whether the user cancelled this interaction (e.g. pressed ESC).
+ * @property {string} [action] - The action identifier (e.g., 'submit', 'exit', 'back').
+ * @property {any} [body] - Additional payload or form data.
+ * @property {any} [form] - The form model instance (if applicable).
+ * @property {number} [index] - The selected index for lists/tables.
  */
 /**
  * Response to an AgentIntent.
@@ -201,6 +219,40 @@ export function agent(task: string, context?: AgentContext): AgentIntent;
  * @typedef {'ask' | 'show' | 'progress' | 'render' | 'agent'} IntentType
  */
 export const INTENT_TYPES: readonly ["ask", "progress", "show", "log", "render", "agent"];
+export type ProgressOptions = {
+    /**
+     * - Absolute total steps.
+     */
+    total?: number | undefined;
+    /**
+     * - Progress tracking ID.
+     */
+    id?: string | undefined;
+    /**
+     * - Width of the progress bar in terminal characters.
+     */
+    width?: number | undefined;
+    /**
+     * - Frames per second update rate limit.
+     */
+    fps?: number | undefined;
+    /**
+     * - Custom format string (e.g. '{time} {bar} {percent} {title}').
+     */
+    format?: string | undefined;
+    /**
+     * - Number of columns (terminal width).
+     */
+    columns?: number | undefined;
+    /**
+     * - Prevent wrapping and truncate instead.
+     */
+    forceOneLine?: boolean | undefined;
+    /**
+     * - Set to true to stop, or 'success'/'error' to stop with a status icon (for spinners).
+     */
+    stop?: boolean | "error" | "success" | undefined;
+};
 export type ShowData = {
     component?: any;
     model?: import("@nan0web/types").Model | undefined;
@@ -275,6 +327,10 @@ export type ProgressIntent = {
      * - Status message from Model (i18n static field value).
      */
     message: string;
+    /**
+     * - Additional options for progress intent.
+     */
+    options?: ProgressOptions | undefined;
 };
 export type ShowLevel = "info" | "warn" | "error" | "success";
 export type LogLevel = ShowLevel;
@@ -310,6 +366,10 @@ export type ResultIntent = {
      * - The raw result data (JSON-serializable).
      */
     data: any;
+    /**
+     * - If true, Adapter MUST output data raw (no UI decorations).
+     */
+    raw?: boolean | undefined;
 };
 /**
  * Model requests rendering of a pure UI component (Header, Footer, Static Map).
@@ -384,7 +444,23 @@ export type AskResponse = {
     /**
      * - Whether the user cancelled this interaction (e.g. pressed ESC).
      */
-    cancelled?: boolean | undefined;
+    cancelled: boolean;
+    /**
+     * - The action identifier (e.g., 'submit', 'exit', 'back').
+     */
+    action?: string | undefined;
+    /**
+     * - Additional payload or form data.
+     */
+    body?: any;
+    /**
+     * - The form model instance (if applicable).
+     */
+    form?: any;
+    /**
+     * - The selected index for lists/tables.
+     */
+    index?: number | undefined;
 };
 /**
  * Response to an AgentIntent.

package/types/core/index.d.ts

@@ -8,6 +8,9 @@ export { IntentErrorModel } from "./IntentErrorModel.js";
 export { runGenerator } from "./GeneratorRunner.js";
 export { MaskHandler } from "./MaskHandler.js";
 export { LayoutModel } from "../domain/LayoutModel.js";
+export type Intent = import("./Intent.js").Intent;
+export type AskResponse = import("./Intent.js").AskResponse;
+export type AskOptions = import("./InputAdapter.js").AskOptions;
 import UIStream from './Stream.js';
 import StreamEntry from './StreamEntry.js';
 import UIForm from './Form/Form.js';

package/types/domain/Content.d.ts

@@ -35,7 +35,7 @@
  * @property {string|ContentData[]} [fieldset]
  * @property {string|ContentData[]} [figcaption]
  * @property {string|ContentData[]} [figure]
- * @property {string|ContentData[]} [footer]
+ * @property {any} [footer]
  * @property {string|ContentData[]} [form]
  * @property {string|ContentData[]} [h1]
  * @property {string|ContentData[]} [h2]
@@ -44,7 +44,7 @@
  * @property {string|ContentData[]} [h5]
  * @property {string|ContentData[]} [h6]
  * @property {string|ContentData[]} [head]
- * @property {string|ContentData[]} [header]
+ * @property {any} [header]
  * @property {string|ContentData[]} [hgroup]
  * @property {boolean|object} [hr]
  * @property {string|ContentData[]} [html]
@@ -136,6 +136,8 @@
  * @property {import('./components/FAQModel.js').FAQModel} [faq]
  * @property {import('./components/FeatureGridModel.js').FeatureGridModel} [featureGrid]
  * @property {import('./components/GalleryModel.js').GalleryModel} [gallery]
+ * @property {import('./HeaderModel.js').HeaderModel} [header]
+ * @property {import('./FooterModel.js').FooterModel} [footer]
  * @property {import('./components/InputModel.js').InputModel} [input]
  * @property {import('./components/MarkdownModel.js').MarkdownModel} [markdown]
  * @property {import('./components/PriceModel.js').PriceModel} [price]
@@ -213,7 +215,7 @@ export type HTML5Elements = {
     fieldset?: string | ContentData[] | undefined;
     figcaption?: string | ContentData[] | undefined;
     figure?: string | ContentData[] | undefined;
-    footer?: string | ContentData[] | undefined;
+    footer?: any;
     form?: string | ContentData[] | undefined;
     h1?: string | ContentData[] | undefined;
     h2?: string | ContentData[] | undefined;
@@ -222,7 +224,7 @@ export type HTML5Elements = {
     h5?: string | ContentData[] | undefined;
     h6?: string | ContentData[] | undefined;
     head?: string | ContentData[] | undefined;
-    header?: string | ContentData[] | undefined;
+    header?: any;
     hgroup?: string | ContentData[] | undefined;
     hr?: boolean | object;
     html?: string | ContentData[] | undefined;
@@ -313,6 +315,8 @@ export type CoreUIElements = {
     faq?: import("./components/FAQModel.js").FAQModel | undefined;
     featureGrid?: import("./components/FeatureGridModel.js").FeatureGridModel | undefined;
     gallery?: import("./components/GalleryModel.js").GalleryModel | undefined;
+    header?: import("./HeaderModel.js").HeaderModel | undefined;
+    footer?: import("./FooterModel.js").FooterModel | undefined;
     input?: import("./components/InputModel.js").InputModel | undefined;
     markdown?: import("./components/MarkdownModel.js").MarkdownModel | undefined;
     price?: import("./components/PriceModel.js").PriceModel | undefined;

package/types/domain/Document.d.ts

@@ -8,6 +8,21 @@ export class Document extends Model {
         model: typeof Content;
         help: string;
     };
+    static $content: {
+        type: string;
+        model: typeof Content;
+        help: string;
+    };
+    static nav: {
+        type: string;
+        model: typeof Navigation;
+        help: string;
+    };
+    static langs: {
+        type: string;
+        model: any;
+        help: string;
+    };
     /**
      *
      * @param {Partial<Document>} [data]
@@ -16,6 +31,10 @@ export class Document extends Model {
     constructor(data?: Partial<Document>, options?: import("@nan0web/types").ModelOptions);
     /** @type {string} Title */ title: string;
     /** @type {Array<Content>} Content */ content: Array<Content>;
+    /** @type {Array<Content>} Layout configuration */ $content: Array<Content>;
+    /** @type {Navigation|string|Array<Navigation>} Navigation config */ nav: Navigation | string | Array<Navigation>;
+    /** @type {Array<Language>} Supported languages */ langs: Array<Language>;
 }
 import { Model } from '@nan0web/types';
 import { Content } from './Content.js';
+import Navigation from './Navigation.js';

package/types/domain/ModelAsApp.d.ts

@@ -5,9 +5,9 @@
 export class ModelAsApp extends Model {
     /**
      * @param {Partial<ModelAsApp> | Record<string, any>} [data={}]
-     * @param {ModelAsAppOptions} [options={}]
+     * @param {Partial<ModelAsAppOptions>} [options={}]
      */
-    constructor(data?: Partial<ModelAsApp> | Record<string, any>, options?: ModelAsAppOptions);
+    constructor(data?: Partial<ModelAsApp> | Record<string, any>, options?: Partial<ModelAsAppOptions>);
     /** @returns {ModelAsAppOptions} */
     get _(): ModelAsAppOptions;
     /**

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

@@ -0,0 +1,21 @@
+export default class ConfigApp extends ModelAsApp {
+    static name: string;
+    static alias: string;
+    static resource: {
+        type: string;
+        help: string;
+        positional: boolean;
+        default: string;
+    };
+    static action: {
+        type: string;
+        help: string;
+        positional: boolean;
+        default: string;
+    };
+    constructor(data?: {}, options?: {});
+    resource: any;
+    action: any;
+    run(): AsyncGenerator<import("../../core/Intent.js").ShowIntent | import("../../core/Intent.js").RenderIntent, import("../../core/Intent.js").ResultIntent, unknown>;
+}
+import { ModelAsApp } from '../ModelAsApp.js';

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

@@ -86,8 +86,8 @@ export class SnapshotAuditor {
      * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
      */
     constructor(data?: Partial<SnapshotAuditor> | Record<string, any>, options?: Partial<import("@nan0web/types").ModelOptions>);
-    /** @type {import('../../index.js').ModelAsAppOptions} */
-    _: import("../../index.js").ModelAsAppOptions;
+    /** @type {import('@nan0web/types').ModelOptions} */
+    options: import("@nan0web/types").ModelOptions;
     /** @type {string} Target directory to audit */ dir: string;
     /** @type {string} Directory to scan for dictionaries */ data: string;
     /**

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

@@ -2,7 +2,7 @@ export class UIApp extends ModelAsApp {
     static command: {
         type: string;
         help: string;
-        options: (typeof SnapshotAuditor | typeof GalleryCommand)[];
+        options: (typeof SnapshotAuditor | typeof GalleryCommand | typeof ConfigApp)[];
         default: string;
         positional: boolean;
     };
@@ -22,7 +22,7 @@ export class UIApp extends ModelAsApp {
     /** @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").AskIntent & {
+    run(): AsyncGenerator<import("../../core/Intent.js").ShowIntent | import("../../core/Intent.js").RenderIntent | (import("../../core/Intent.js").AskIntent & {
         $value?: any;
         $success?: boolean;
         $files?: Record<string, string>;
@@ -37,11 +37,6 @@ 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;
@@ -58,3 +53,4 @@ export default UIApp;
 import { ModelAsApp } from '../ModelAsApp.js';
 import SnapshotAuditor from './SnapshotAuditor.js';
 import GalleryCommand from './GalleryCommand.js';
+import ConfigApp from './ConfigApp.js';

package/types/index.d.ts

@@ -21,6 +21,7 @@ export type Intent = import("./core/Intent.js").Intent;
 export type IntentResponse = import("./core/Intent.js").IntentResponse;
 export type AskIntent = import("./core/Intent.js").AskIntent;
 export type ProgressIntent = import("./core/Intent.js").ProgressIntent;
+export type ProgressOptions = import("./core/Intent.js").ProgressOptions;
 export type LogIntent = import("./core/Intent.js").LogIntent;
 export type ShowIntent = import("./core/Intent.js").ShowIntent;
 export type RenderIntent = import("./core/Intent.js").RenderIntent;
@@ -29,6 +30,7 @@ export type IntentType = import("./core/Intent.js").IntentType;
 export type AskResponse = import("./core/Intent.js").AskResponse;
 export type AbortResponse = import("./core/Intent.js").AbortResponse;
 export type ShowData = import("./core/Intent.js").ShowData;
+export type AskOptions = import("./core/InputAdapter.js").AskOptions;
 export type ModelAsAppOptions = import("./domain/index.js").ModelAsAppOptions;
 import Frame from './Frame/Frame.js';
 import FrameProps from './Frame/Props.js';

package/types/testing/SpecAdapter.d.ts

@@ -17,6 +17,7 @@ export class SpecAdapter {
      */
     ask(intent: import("../core/Intent.js").AskIntent): Promise<{
         value: any;
+        cancelled: boolean;
     }>;
     /**
      * @param {import('../core/Intent.js').ShowIntent} intent