@feasibleone/blong 1.18.0 → 1.18.2

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.18.2](https://github.com/feasibleone/blong/compare/blong-v1.18.1...blong-v1.18.2) (2026-05-10)
+
+
+### Bug Fixes
+
+* avoid re-rendering ([183b718](https://github.com/feasibleone/blong/commit/183b718451e8166fa85bd1258ae62ede474db3d1))
+
+## [1.18.1](https://github.com/feasibleone/blong/compare/blong-v1.18.0...blong-v1.18.1) (2026-05-09)
+
+
+### Bug Fixes
+
+* improve model and mock ([20b530c](https://github.com/feasibleone/blong/commit/20b530cc9d00284a52ad99b63b95fbb7bd4e4e82))
+* update widget imports to use centralized types from '@feasibleone/blong' ([5a2a4d2](https://github.com/feasibleone/blong/commit/5a2a4d23762de4eb9c00c2be1f3138673c1cb38f))
+
 ## [1.18.0](https://github.com/feasibleone/blong/compare/blong-v1.17.0...blong-v1.18.0) (2026-04-29)
 
 

package/dist/model.js

@@ -1,10 +1,2 @@
-/**
- * Model system types.
- *
- * A ModelSpec describes one "subject.object" domain entity and drives:
- * - automatic Browse / New / Open / Report page generation
- * - schema enrichment (server OpenAPI merged with browser overlay)
- * - dropdown dependency tracking and caching
- */
 export {};
 //# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../model.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -9,6 +9,7 @@ import { Dirent, StatSyncFn } from 'node:fs';
 import { Agent } from 'node:http';
 import { Duplex } from 'node:stream';
 import { Level, LogFn, Logger as PinoLogger } from 'pino';
+import React$1 from 'react';
 import { Readable, Writable } from 'stream';
 import { ConnectionOptions as ConnectionOptions_2, TLSSocket, TLSSocketOptions } from 'tls';
 import { Static, TArray, TBoolean, TFunction, TNever, TNumber, TObject, TSchema, TString, TUnknown, Type } from 'typebox';
@@ -17574,6 +17575,335 @@ declare namespace DeferredKeySelection {
 }
 export type AggregationQueryResult<TResult, TIntersectProps2 extends {}> = ArrayIfAlready<TResult, UnwrapArrayMember<TResult> extends DeferredKeySelection<infer TBase, infer TKeys, infer THasSelect, infer TAliasMapping, infer TSingle, infer TIntersectProps, infer TUnionProps> ? true extends THasSelect ? DeferredKeySelection<TBase, TKeys, THasSelect, TAliasMapping, TSingle, TIntersectProps & TIntersectProps2, TUnionProps> : DeferredKeySelection<{}, never, true, {}, false, TIntersectProps2> : TIntersectProps2>;
 export type ResolveResult<S> = DeferredKeySelection.Resolve<S>;
+/** All supported widget types */
+export type WidgetType = "input" | "mask" | "text" | "textArea" | "password" | "number" | "integer" | "currency" | "percent" | "boolean" | "checkbox" | "switch" | "date" | "time" | "dateTime" | "dateRange" | "dropdown" | "dropdownTree" | "select" | "selectTable" | "multiSelect" | "multiSelectTree" | "multiSelectPanel" | "multiSelectTreeTable" | "chips" | "file" | "image" | "imageUpload" | "autocomplete" | "table" | "navigator" | "json" | "code" | "divider" | "label" | "link" | "custom";
+/** Base widget configuration (stored in schema x-widget) */
+export interface IWidgetConfig {
+	type: WidgetType;
+	/** For dropdown/multiSelect — action name to fetch options */
+	fetch?: string;
+	/** Named dropdown key — loads options via portal.dropdown.list */
+	dropdown?: string;
+	/** Options list for static select/multiSelect/select/tree widgets.
+	 * Flat options use `{value, label}`. TreeNode-style options use `{key, label, children}`. */
+	options?: Array<{
+		value?: unknown;
+		label?: string;
+		icon?: string;
+		key?: string | number;
+		children?: unknown[];
+		[extra: string]: unknown;
+	}>;
+	/** Parent field name for cascaded dropdowns/tables (supports '$.selected.field' or just 'field') */
+	parent?: string;
+	/** Key mapping for cascaded table filtering: {ownKey: parentKey} */
+	master?: Record<string, string>;
+	/** Auto-select first filtered row when parent selection changes */
+	autoSelect?: boolean;
+	/** Copy-to-clipboard icon (input widget) */
+	copy?: boolean;
+	/** Mask pattern (mask widget) */
+	mask?: string;
+	/** Column definitions for table widget */
+	columns?: string[] | Record<string, IFieldConfig>;
+	/** Pivot config for static or dynamic pivots */
+	pivot?: IPivotConfig;
+	/** Field names to hide in table (used as implicit keys) */
+	hidden?: string[];
+	/** Selection mode for table widget */
+	selectionMode?: "single" | "multiple";
+	/** Label shown inside the widget (e.g. as table toolbar title instead of field label) */
+	label?: string;
+	/** Label field name in fetched options */
+	labelField?: string;
+	/** Value field name in fetched options */
+	valueField?: string;
+	/** Render this widget in read-only display mode regardless of card/form edit-ability */
+	readOnly?: boolean;
+	/** Custom component type (for 'custom' type) */
+	component?: React$1.ComponentType<IWidgetProps>;
+	/** Table action permissions */
+	actions?: {
+		allowAdd?: boolean;
+		allowDelete?: boolean;
+		allowEdit?: boolean;
+		allowSelect?: boolean;
+	};
+	/** Whether to show the inline editor directly inside the cell (boolean/dropdown) */
+	inlineEdit?: boolean;
+	/** Accepted file types (file/imageUpload widgets) */
+	accept?: string;
+	/** Maximum file size in bytes (file/image widgets) */
+	maxSize?: number;
+	/** Base URL prefix for image display (image/imageUpload widgets) */
+	basePath?: string;
+	/** Exclude boundary times (dateRange widget: end = 23:59:59 instead of 00:00:00 next day) */
+	exclusive?: boolean;
+	/** Show time-only pickers (dateRange/time widget) */
+	timeOnly?: boolean;
+	/**
+	 * Action name to load list data from the server (table + navigator widgets).
+	 * When set, the widget manages its own data loading, pagination, search, and
+	 * sort independently of the react-hook-form value.
+	 */
+	listAction?: string;
+	/** Static params merged into every `listAction` call */
+	listParams?: Record<string, unknown>;
+	/**
+	 * Property name in the `listAction` response that contains the rows array.
+	 * Defaults to `'items'`. Set to `''` to use the response directly as an array.
+	 */
+	resultSet?: string;
+	/** Initial rows per page for listAction mode (default 25) */
+	pageSize?: number;
+	/**
+	 * Primary key field name in row data — used for template resolution (`${id}`)
+	 * and for the DataTable `dataKey`. Defaults to `'id'`.
+	 */
+	keyField?: string;
+	/** Parent key field for navigator tree building (default 'parentId') */
+	parentField?: string;
+	/**
+	 * Custom toolbar buttons (left side). Support `${id}`, `${current}`, `${selected}`,
+	 * and `${current.field}` template resolution and `enabled: 'current' | 'selected'`.
+	 */
+	toolbar?: IWidgetToolbarButton[];
+	/** Custom toolbar buttons (right side) */
+	toolbarRight?: IWidgetToolbarButton[];
+}
+/**
+ * Toolbar button for widget-level toolbars (table, navigator).
+ * Similar to IToolbarButton but scoped to widget-level row context.
+ */
+export interface IWidgetToolbarButton {
+	label?: string;
+	icon?: string;
+	/** Direct RPC method name called via dispatch */
+	method?: string;
+	permission?: string;
+	/** Confirmation dialog message before invoking */
+	confirm?: string;
+	/** Enabled condition based on current row selection */
+	enabled?: boolean | "current" | "selected";
+	/**
+	 * Params passed to the method. Supports template strings:
+	 * `${id}` → keyField value, `${current}` → current row,
+	 * `${selected}` → selected rows array, `${current.field}` → field of current row.
+	 */
+	params?: Record<string, unknown> | string;
+	/** Success hint text shown as overlay near the button after the action completes */
+	successHint?: string;
+}
+/** Pivot config for table widget */
+export interface IPivotConfig {
+	/** Static pivot: fixed row examples */
+	examples?: Record<string, unknown>[];
+	/** Dynamic pivot: field name of the dropdown whose options feed the rows */
+	dropdown?: string;
+	/** Key mapping from examples/options to data array */
+	join: {
+		example?: string;
+		option?: string;
+		item: string;
+	};
+}
+/** Object entry in a card's widget list — renders the named array field as a table, showing only the specified columns */
+export interface ICardWidgetEntry {
+	/** Field name from the schema (must be a table/array field) */
+	name: string;
+	/** Unique render key (allows showing the same field multiple times with different column subsets) */
+	id: string;
+	/** Column names from the field's items.properties to display */
+	widgets: string[];
+}
+/** Field configuration within a card */
+export interface IFieldConfig {
+	title?: string;
+	widget?: Partial<IWidgetConfig>;
+	readOnly?: boolean;
+	hidden?: boolean;
+	required?: boolean;
+}
+/** Card configuration */
+export interface ICardConfig {
+	label?: string;
+	/** Field list for this card (preferred alias: widgets) */
+	fields?: Record<string, IFieldConfig> | string[];
+	/** Alias for fields — supports plain field names or ICardWidgetEntry objects for column-subset table views */
+	widgets?: (string | ICardWidgetEntry)[];
+	className?: string;
+	readOnly?: boolean;
+	collapsible?: boolean;
+	loading?: boolean;
+	/** When true: card is not shown visually; fields render as hidden inputs */
+	hidden?: boolean;
+	/** Permission key required to display this card. If set and no checkPermission
+	 *  callback is provided (or it returns false), the card is not rendered. */
+	permission?: string;
+	/** Watch path for reactive cards (e.g. '$.selected.personTable') */
+	watch?: string;
+	/** Match condition to show polymorphic detail cards */
+	match?: Record<string, unknown>;
+	/** Parent table path for master-detail */
+	parent?: string;
+	/** Master-detail key mapping */
+	master?: Record<string, string>;
+	autoSelect?: boolean;
+}
+/** Props that every widget component receives */
+export interface IWidgetProps {
+	/** Field id — forwarded to the inner control for label/id association (same value as name) */
+	id?: string;
+	name: string;
+	schema: IEnrichedFieldSchema;
+	value: unknown;
+	onChange: (value: unknown) => void;
+	onBlur: () => void;
+	error?: {
+		message?: string;
+	};
+	readOnly?: boolean;
+	loading?: boolean;
+	disabled?: boolean;
+	/** All current form values — enables inter-widget reactivity (cascaded dropdowns etc.) */
+	formValues?: Record<string, unknown>;
+	/**
+	 * Called by table widgets when a row is selected (selectionMode: 'single').
+	 * Passes null when the selection is cleared.
+	 */
+	onSelect?: (name: string, selection: {
+		row: Record<string, unknown>;
+		index: number;
+	} | null) => void;
+	/** Dropdown option maps — keyed by dropdown name, each value is the options array.
+	 *  Passed to TableWidget so column-level dropdown schemas can resolve their options. */
+	dropdowns?: Record<string, unknown[]>;
+}
+/** Widget registry interface */
+export interface IWidgetRegistry {
+	register(type: string, component: React$1.ComponentType<IWidgetProps>): void;
+	get(type: string): React$1.ComponentType<IWidgetProps> | undefined;
+	list(): string[];
+}
+/** Enriched field schema — normalized JSON Schema with widget config */
+export interface IEnrichedFieldSchema {
+	title?: string;
+	type?: string;
+	/** JSON Schema format (e.g. 'date', 'date-time', 'email') */
+	format?: string;
+	description?: string;
+	/** Placeholder text for input widgets */
+	placeholder?: string;
+	minLength?: number;
+	maxLength?: number;
+	minimum?: number;
+	maximum?: number;
+	pattern?: string;
+	enum?: unknown[];
+	readOnly?: boolean;
+	required?: boolean;
+	/** Normalized widget config */
+	widget?: IWidgetConfig;
+	/** Nested object properties — for composite/grouped fields accessed via dot-notation paths */
+	properties?: Record<string, IEnrichedFieldSchema>;
+	/** JSON Schema items — describes the shape of array-field rows (used by TableWidget) */
+	items?: {
+		properties?: Record<string, IEnrichedFieldSchema | Record<string, unknown>>;
+	};
+	/** Include field in filter panel */
+	"x-filter"?: boolean;
+	/** Enable inline column filtering (shows filter row in DataTable) */
+	"x-filterable"?: boolean;
+	/** Enable column sorting */
+	"x-sort"?: boolean;
+	/** Action method name — renders the field cell as a clickable link */
+	action?: string;
+	/** Card names to show this field in */
+	"x-cards"?: string[];
+	/** Raw x-widget extension from OpenAPI */
+	"x-widget"?: Partial<IWidgetConfig>;
+	/** Field name */
+	name?: string;
+}
+/** Enriched object schema — normalized JSON Schema for an entity */
+export interface IEnrichedSchema {
+	title?: string;
+	description?: string;
+	properties?: Record<string, IEnrichedFieldSchema>;
+	required?: string[];
+	/** Schema name (e.g. 'model.tree') */
+	name?: string;
+}
+/** Extended action reference — action name plus static params override */
+export interface IActionRef {
+	name: string;
+	params?: Record<string, unknown>;
+}
+/** Toolbar button configuration */
+export interface IToolbarButton {
+	label?: string;
+	icon?: string;
+	/** Action name (string) or extended ref */
+	action?: string | IActionRef;
+	/** Direct RPC method name (bypass action registry) */
+	method?: string;
+	permission?: string;
+	/** Trigger form submit before invoking */
+	submit?: boolean;
+	/** Confirmation dialog message before invoking */
+	confirm?: string;
+	/** Enabled condition */
+	enabled?: boolean | "dirty" | "clean" | "current" | "selected";
+	visible?: boolean;
+	align?: "left" | "right";
+	/** Split-button sub-items */
+	menu?: IToolbarButton[];
+	/** Extra params passed to the action/method on invocation.
+	 * May be a plain object or a string template using `${field}`, `${current}`,
+	 * `${selected}` and `${current.field}` syntax for row-context interpolation. */
+	params?: Record<string, unknown> | string;
+	/** Success hint text shown in an overlay near the button after the action completes */
+	successHint?: string;
+}
+export type LayoutRow = string | (string | string[])[];
+export type FlatLayoutConfig = LayoutRow[];
+/** A single tab/step item in a tab or steps layout */
+export interface ILayoutTabItem {
+	id: string;
+	label?: string;
+	icon?: string;
+	/** Card names shown in this tab/step. A string is a single-card deck; a string[] is a
+	 *  multi-card deck where all cards are stacked vertically in the same grid column. */
+	widgets: (string | string[])[];
+	/** Optional React component rendered in place of cards (e.g. Explorer) */
+	component?: React$1.ComponentType;
+}
+/** Tab or steps layout (object form) */
+export interface ITabLayoutConfig {
+	orientation?: "top" | "left" | "bottom" | "right";
+	type?: "steps";
+	items: ILayoutTabItem[];
+}
+/** A single panel in a split layout */
+export interface ISplitLayoutPanel {
+	/** Panel size as percentage (default auto-distributed) */
+	size?: number;
+	/** Minimum size in pixels */
+	minSize?: number;
+	/** Card names rendered in this panel (stacked vertically) */
+	cards: string[];
+}
+/**
+ * Split layout — renders cards in resizable side-by-side panels using a Splitter.
+ * Ideal for navigator + table + details explorer-style layouts.
+ */
+export interface ISplitLayoutConfig {
+	type: "split";
+	/** Panel orientation: 'horizontal' (default) = side by side, 'vertical' = top/bottom */
+	orientation?: "horizontal" | "vertical";
+	panels: ISplitLayoutPanel[];
+}
+export type LayoutConfig = FlatLayoutConfig | ITabLayoutConfig | ISplitLayoutConfig;
 /**
  * Model system types.
  *
@@ -17665,20 +17995,22 @@ export interface IBrowserConfig {
 	title?: string;
 	icon?: string;
 	permission?: IBrowserPermissions;
-	/** Column transformation applied to server fetch params */
-	fetch?: (params: Record<string, unknown>) => Record<string, unknown>;
 	/** Default filter applied on page open */
 	filter?: Record<string, unknown>;
 	/** Result set key to use from server response */
 	resultSet?: string;
+	/** Extra toolbar buttons */
+	toolbar?: IToolbarButton[];
+}
+export interface IBrowserConfigOptional {
+	/** Column transformation applied to server fetch params */
+	fetch?: (params: Record<string, unknown>) => Record<string, unknown>;
 	/** Whether to show "Create" button */
 	create?: Array<{
 		title?: string;
 		type?: string;
 		permission?: string;
 	}>;
-	/** Extra toolbar buttons */
-	toolbar?: unknown[];
 }
 /** Editor page configuration */
 export interface IEditorConfig {
@@ -17717,18 +18049,15 @@ export interface IModelSpec {
 	/** JSON Schema overlay merged on top of server OpenAPI schema */
 	schema?: ISchemaOverlay;
 	/** Named card layout definitions */
-	cards?: Record<string, ICardOverride>;
+	cards?: Record<string, ICardConfig>;
 	/** Browse page configuration */
-	browser?: IBrowserConfig;
+	browser?: IBrowserConfig & IBrowserConfigOptional;
 	/** Editor page configuration */
 	editor?: IEditorConfig;
 	/** Report page configuration */
 	report?: IReportConfig;
 	/** Tab layouts for editor */
-	layouts?: {
-		edit?: ILayoutTab[] | string[];
-		[key: string]: unknown;
-	};
+	layouts?: Record<string, LayoutConfig>;
 	/** Method name overrides */
 	methods?: IMethodsConfig;
 }
@@ -17739,9 +18068,7 @@ export interface IResolvedModelSpec extends Required<IModelSpec> {
 	objectTitle: string;
 	keyField: string;
 	nameField: string;
-	browser: Required<IBrowserConfig> & {
-		permission: IBrowserPermissions;
-	};
+	browser: Required<IBrowserConfig> & IBrowserConfigOptional;
 	editor: Required<IEditorConfig>;
 	report: Required<IReportConfig>;
 	methods: Required<IMethodsConfig>;
@@ -17801,7 +18128,7 @@ export type ConfigDiff = Map<string, {
 /** Subscriber callback invoked after a successful reload */
 export type ConfigSubscriber = (diff: ConfigDiff, next: object, prev: object) => void | Promise<void>;
 /**
- * Mode used when the config proxy is queried during handler factory initialisation.
+ * Mode used when the config proxy is queried during handler factory initialization.
  *
  * - `'throw'`   — throw immediately (default; keeps misuse from going unnoticed)
  * - `'collect'` — accumulate errors and return them from exitConfigFactoryPhase()
@@ -17868,6 +18195,7 @@ export interface IPlatformApi {
 		isAfter: (time: HRTime, timeout: HRTime) => boolean;
 		spare: (time: HRTime, latency?: number) => number;
 	};
+	configs: string[];
 }
 export interface IErrorFactory {
 	get(type?: string): unknown;

package/dist/types.js.map

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

package/dist/widget.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=widget.js.map

package/dist/widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.js","sourceRoot":"","sources":["../widget.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feasibleone/blong",
-  "version": "1.18.0",
+  "version": "1.18.2",
   "description": "API and DRY focused RAD framework https://feasibleone.github.io/blong-docs",
   "keywords": [
     "blong",
@@ -34,6 +34,7 @@
     "@rushstack/heft-typescript-plugin": "^1.3.1",
     "@slack/types": "^2.20.1",
     "@slack/webhook": "^7.0.7",
+    "@types/react": "^19.1.2",
     "@types/request": "^2.48.13",
     "@types/ut-function.merge": "file:./types/ut-function.merge",
     "bson": "^7.2.0",
@@ -43,6 +44,7 @@
     "mongodb": "^7.1.0",
     "node-vault": "^0.10.10",
     "openapi-types": "^12.1.3",
+    "react": "^19.1.0",
     "tarn": "^3.0.2",
     "typescript": "^5.9.3"
   },

package/types.ts

@@ -31,7 +31,7 @@ import type {Duplex} from 'node:stream';
 import type {OpenAPI, OpenAPIV2, OpenAPIV3_1} from 'openapi-types';
 import type {Level, LogFn, Logger as PinoLogger} from 'pino';
 import merge from 'ut-function.merge';
-import type {Knex} from './knex.js';
+import type {Knex} from './knex.ts';
 import type {IMock, IModelSpec} from './model.ts';
 
 // export {
@@ -49,6 +49,7 @@ export type {IJsonSchema, OpenAPI, OpenAPIV2, OpenAPIV3, OpenAPIV3_1} from 'open
 // export type {Level, LogFn, Logger as PinoLogger} from 'pino';
 export type {Knex} from './knex.js';
 export type * from './model.ts';
+export type * from './widget.ts';
 
 export type ServerContext = {
     queryBuilder?: Knex;
@@ -94,7 +95,7 @@ export type ConfigSubscriber = (
 ) => void | Promise<void>;
 
 /**
- * Mode used when the config proxy is queried during handler factory initialisation.
+ * Mode used when the config proxy is queried during handler factory initialization.
  *
  * - `'throw'`   — throw immediately (default; keeps misuse from going unnoticed)
  * - `'collect'` — accumulate errors and return them from exitConfigFactoryPhase()
@@ -160,6 +161,7 @@ export interface IPlatformApi {
         isAfter: (time: HRTime, timeout: HRTime) => boolean;
         spare: (time: HRTime, latency?: number) => number;
     };
+    configs: string[];
 }
 
 export interface IErrorFactory {