@nan0web/ui 1.11.0 → 1.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nan0web/ui",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "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"
@@ -72,21 +76,21 @@
     "vitest": "^3.2.4",
     "@nan0web/db-fs": "1.2.1",
     "@nan0web/event": "1.0.1",
+    "@nan0web/icons": "1.1.0",
     "@nan0web/i18n": "1.5.0",
+    "@nan0web/ui-cli": "2.13.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/nan0web.app": "0.1.0",
+    "@nan0web/release": "1.0.3",
     "@nan0web/ui-lit": "1.1.0"
   },
   "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.2"
   },
   "scripts": {
     "prebuild": "rm -rf types/",

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.
  */
 
 /**
@@ -118,7 +119,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 +249,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 = {}) {

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/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/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/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;
@@ -98,6 +109,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
@@ -163,7 +175,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 +217,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 +325,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;
@@ -384,7 +438,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/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/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