@isi-ui7/bos7-shared 0.2.4 → 0.2.6

package/dist/crud-components.d.ts

@@ -3,6 +3,8 @@ import { CrudDeleteSchema, CrudListSchema } from './crud-types';
 import { CrudForm, FormMode } from './form-types';
 import { Ui7FormDensity } from './style-contract';
 
+export { buildValueSections, buildXRulesValidator, } from './form-value-schema';
+export type { JSONSchema, XUi, XUiRoot, XUiNumeric, XUiOption, XUiWidget, XRule, XRuleOp, ValueValidatorFn, } from './form-value-schema';
 export declare function SharedCrudListPage({ schema, tableKey, onAdd, onPopupClick }: {
     schema: CrudListSchema;
     tableKey?: number;

package/dist/crud-hooks.d.ts

@@ -12,4 +12,4 @@ export declare function applyCrudFieldOverrides<TField extends {
     readonly?: boolean;
     required?: boolean;
     helperText?: unknown;
-}>(fields: TField[], hooks?: CrudActionOverrideHooks<Record<string, unknown>> | CrudActionOverrideHooks<any>): TField[];
+}, TData extends Record<string, unknown> = Record<string, unknown>>(fields: TField[], hooks?: CrudActionOverrideHooks<TData>): TField[];

package/dist/crud-types.d.ts

@@ -63,8 +63,6 @@ export type CrudListSchema = {
     showSort?: boolean;
     /** Enable search bar. Defaults to true. */
     showSearch?: boolean;
-    /** Endpoint for LookupInput (defaults to apiPath if omitted). In Pattern B both DataTable and LookupInput share the same /query endpoint. */
-    lookupApiPath?: string;
     /**
      * Level 2: schema-driven confirmation modals for custom popup actions.
      * Keyed by popup menu item id. Actions not listed here fall through to onCustomAction (Level 1).

package/dist/form-numeric.d.ts

@@ -33,3 +33,15 @@ export declare const INDONESIA_PHONE_RULE: PhoneRule;
 export declare const GLOBAL_PHONE_RULE: PhoneRule;
 /** Standard currency precision for Indonesian banking (IDR 2 dec, USD 4 dec). */
 export declare const INDONESIA_CURRENCY_CONFIG: CurrencyPrecisionConfig;
+/**
+ * Whole-rupiah currency config — used for ledger-style fields like plafond,
+ * subsidi, agent limit, where the convention in Indonesian retail banking is
+ * to round to whole IDR (no sen). USD/USD-denominated fields still keep 2
+ * decimals (standard cents). Default precision is 0 so any other currency
+ * defaults to whole units in these contexts.
+ *
+ * Use this for "agent plafond / saldo / subsidi" style fields. For amounts
+ * that genuinely need sub-rupiah precision (e.g. percentage-derived fees,
+ * accrued interest), prefer `INDONESIA_CURRENCY_CONFIG` instead.
+ */
+export declare const INDONESIA_RUPIAH_WHOLE_CONFIG: CurrencyPrecisionConfig;

package/dist/form-renderer.d.ts

@@ -1,4 +1,4 @@
-import { Ui7FormDensity } from './style-contract';
+import { Ui7FormDensity, Ui7FormWidth } from './style-contract';
 import { FormMode, FormSection } from './form-types';
 
 export type SchemaFormRendererProps<TData extends Record<string, unknown>> = {
@@ -14,5 +14,7 @@ export type SchemaFormRendererProps<TData extends Record<string, unknown>> = {
     scopeClassName?: string;
     /** Form layout density. Defaults to "compact". */
     density?: Ui7FormDensity;
+    /** Desktop form-panel width. Defaults to "two-thirds". */
+    width?: Ui7FormWidth;
 };
-export declare function SchemaFormRenderer<TData extends Record<string, unknown>>({ mode, value, sections, errors, disabled, onChange, className, showSectionHeader, scopeClassName, density, }: SchemaFormRendererProps<TData>): import("react/jsx-runtime").JSX.Element;
+export declare function SchemaFormRenderer<TData extends Record<string, unknown>>({ mode, value, sections, errors, disabled, onChange, className, showSectionHeader, scopeClassName, density, width, }: SchemaFormRendererProps<TData>): import("react/jsx-runtime").JSX.Element;

package/dist/form-types.d.ts

@@ -1,6 +1,7 @@
 import { ReactNode } from 'react';
-import { Ui7FormDensity } from './style-contract';
+import { Ui7FormDensity, Ui7FormWidth } from './style-contract';
 import { T_LookupTblStruct } from '@isi-ui7/lookup-input';
+import { EditableColumnDef } from '@isi-ui7/editable-table';
 
 export type FormMode = "create" | "edit" | "view";
 export type ApiPath = string | ((params: Record<string, string>) => string);
@@ -18,7 +19,7 @@ export type FieldValidation<TData extends Record<string, unknown>> = {
     /** Array of validators — compose Rules.* or custom functions. Runs after built-in rules. */
     validators?: FieldValidatorFn<TData>[];
 };
-export type FormFieldType = "text" | "textarea" | "number" | "date" | "select" | "lookup" | "checkbox" | "toggle";
+export type FormFieldType = "text" | "textarea" | "number" | "date" | "select" | "lookup" | "checkbox" | "toggle" | "detail-rows";
 export type FormFieldOption = {
     value: string;
     label: string;
@@ -33,6 +34,17 @@ export type FormFieldLookupConfig<TData extends Record<string, unknown>> = {
     dataSource?: "api" | "direct";
     /** Return a patch to merge into the form when a lookup row is selected. */
     onDataPatch?: (row: Record<string, unknown>, data: TData) => Partial<TData>;
+    /**
+     * Form field keys whose values combine into the initial display text on
+     * Edit load. Example: `["kode_cabang","branch_name"]` renders
+     * "001 KANTOR CABANG BANDUNG" instead of just "001". Typical pairing
+     * with an onDataPatch that stashes the picked row's name into a
+     * companion field. If any referenced field is empty, the lookup falls
+     * back to the field's own primary-key value.
+     */
+    initialDisplayFields?: (keyof TData)[];
+    /** Separator joining initialDisplayFields. Default: " " */
+    initialDisplaySeparator?: string;
 };
 export type FormFieldNumericConfig<TData extends Record<string, unknown>> = {
     kind: "currency";
@@ -50,11 +62,51 @@ export type FormFieldNumericConfig<TData extends Record<string, unknown>> = {
     maxDigits: number;
     allowedPrefixes?: string[];
 };
+/**
+ * Toggle field state mapping for non-boolean stored values.
+ *
+ * Example for a "Y" / "N" string column:
+ *   { type: "toggle", toggle: { valueOn: "Y", valueOff: "N" } }
+ *
+ * Toggled = (current value === valueOn). Flipping the toggle writes
+ * either `valueOn` or `valueOff` into the form data. Defaults to
+ * boolean true / false when omitted.
+ */
+export type FormFieldToggleConfig = {
+    valueOn?: unknown;
+    valueOff?: unknown;
+};
+/**
+ * Detail-rows config — embeds an inline `<EditableTable>` inside the form for
+ * master-detail entry. The field value at `key` must be an array of plain
+ * objects (e.g. `details: BucketRow[]`). The renderer reads / writes that
+ * array atomically via `onChange({ ...data, [key]: newRows })`.
+ *
+ * `columns`, `newRowFactory`, `validateRow`, `maxRows` mirror the props of
+ * `<EditableTable>` from `@isi-ui7/editable-table`.
+ */
+export type DetailRowsConfig = {
+    columns: EditableColumnDef[];
+    newRowFactory: () => Record<string, unknown>;
+    validateRow?: (row: Record<string, unknown>, index: number) => Record<string, string>;
+    maxRows?: number;
+};
 export type FormField<TData extends Record<string, unknown>> = {
     key: keyof TData;
     label: ReactNode;
     type: FormFieldType;
     span?: number;
+    /**
+     * Force this field to start a new row even when the current row still
+     * has space for its `span`. Useful to break a logical group onto its
+     * own line (e.g. a wide picker that should sit alone, or a sub-group
+     * header pattern within one section).
+     *
+     * Implemented via `gridColumnStart: 1` — the CSS grid skips the
+     * remaining columns of the previous row and places this field at the
+     * left edge of a new row.
+     */
+    breakBefore?: boolean;
     /** Static or dynamic readonly. Function receives current mode + form data. */
     readonly?: boolean | ((mode: FormMode, data: TData) => boolean);
     /** Static or dynamic visibility. Hidden fields are skipped in validation. */
@@ -69,6 +121,8 @@ export type FormField<TData extends Record<string, unknown>> = {
     options?: FormFieldOption[];
     lookup?: FormFieldLookupConfig<TData>;
     numeric?: FormFieldNumericConfig<TData>;
+    toggle?: FormFieldToggleConfig;
+    detailRows?: DetailRowsConfig;
     format?: (value: TData[keyof TData], data: TData) => ReactNode;
     validation?: FieldValidation<TData>;
 };
@@ -119,6 +173,11 @@ export type CrudForm<TData extends Record<string, unknown>> = {
     };
     /** Form layout density. Defaults to "compact". */
     density?: Ui7FormDensity;
+    /**
+     * Desktop form-panel width — "half" | "two-thirds" | "full".
+     * Default "two-thirds". Tablet + mobile (<1056px) always stretch full.
+     */
+    width?: Ui7FormWidth;
     emptyData: TData;
     createApiPath: ApiPath;
     updateApiPath?: ApiPath;

package/dist/form-value-schema.d.ts

@@ -0,0 +1,118 @@
+import { FormMode, FormSection } from './form-types';
+
+export type T = (key: string, fallback?: string) => string;
+export type XUiNumeric = {
+    kind: "currency" | "percent" | "integer" | "phone";
+    /** currency: name of the sibling field holding the currency code. */
+    currencyField?: string;
+    precisionByCurrency?: Record<string, number>;
+    defaultPrecision?: number;
+    /** percent. */
+    maxFractionDigits?: number;
+    /** phone. */
+    minDigits?: number;
+    maxDigits?: number;
+    allowedPrefixes?: string[];
+};
+export type XUiOption = {
+    value: string;
+    labelKey?: string;
+    label?: string;
+};
+export type XUiWidget = "text" | "textarea" | "number" | "select" | "date" | "toggle" | "lookup" | "detail-rows";
+/** Per-property `x-ui` hint object (also array-level for `detail-rows`). */
+export type XUi = {
+    widget?: XUiWidget;
+    labelKey?: string;
+    label?: string;
+    helpKey?: string;
+    help?: string;
+    /** 1–12 grid width. Default 6. */
+    span?: number;
+    /** Sort order within an inferred section. */
+    order?: number;
+    /** Modes in which the field renders read-only, e.g. ["edit"]. */
+    readonlyOn?: FormMode[];
+    placeholder?: string;
+    numeric?: XUiNumeric;
+    /** `select` options (overrides enum labels). */
+    options?: XUiOption[];
+    /** Named dynamic-options source — deferred in Wave C (resolved by FE). */
+    optionsRef?: string;
+    lookup?: {
+        api: string;
+        valueField?: string;
+        displayFields?: string[];
+    };
+    toggle?: {
+        valueOn?: unknown;
+        valueOff?: unknown;
+    };
+    /** array `detail-rows`: max number of rows. */
+    maxRows?: number;
+};
+/** Root-level `x-ui` (layout grouping + density). */
+export type XUiRoot = XUi & {
+    layout?: {
+        sections?: Array<{
+            titleKey?: string;
+            title?: string;
+            fields: string[];
+        }>;
+    };
+    density?: string;
+};
+export type JSONSchema = {
+    type?: string;
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    enum?: unknown[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    default?: unknown;
+    items?: JSONSchema;
+    "x-ui"?: XUiRoot;
+    "x-rules"?: XRule[];
+};
+export type XRuleOp = "lte" | "gte" | "lt" | "gt" | "eq" | "required-if";
+export type XRule = {
+    op: XRuleOp;
+    left: string;
+    /** Other field to compare against (lte/gte/lt/gt/eq, or the condition field of required-if). */
+    right?: string;
+    /** Literal to compare against (eq) or the condition value (required-if). */
+    value?: unknown;
+    message?: string;
+    /** i18n key for the message (preferred over `message`). */
+    messageKey?: string;
+};
+type ValueData = Record<string, unknown>;
+export type ValueValidatorFn = (data: ValueData) => Partial<Record<string, string>>;
+/**
+ * Build a form-level validator from `x-rules`. Comparison ops skip when either
+ * operand is empty/non-numeric (per-field `required` handles emptiness), so the
+ * cross-field check only fires on otherwise-complete input. Returns errors keyed
+ * by the offending field so the page blocks submit before `startWorkflow`.
+ */
+export declare function buildXRulesValidator(rules: XRule[] | undefined, t: T): ValueValidatorFn;
+/**
+ * Build the "value" form section(s) + a cross-field validator from a policy7
+ * `value_schema`. Pure; no fetch.
+ *
+ * @example
+ *   const { sections, validate } = buildValueSections(valueSchema, t);
+ *   const form: CrudForm<Data> = {
+ *     ...,
+ *     layout: { type: "single-page", sections: [scopeSection(t), ...sections] },
+ *     validate: (data) => ({ ...scopeValidate(data), ...validate(data) }),
+ *   };
+ */
+export declare function buildValueSections(valueSchema: JSONSchema, t: T): {
+    sections: FormSection<ValueData>[];
+    validate: ValueValidatorFn;
+};
+export {};

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export * from './notifications-bff';
 export * from './crud-types';
 export * from './crud-hooks';
 export * from './form-types';
+export * from './form-value-schema';
 export * from './i18n';
 export { proxyBackendPost, proxyQueryRoute } from './data-table/proxy';
 export type { ProxyBackendPostOptions, ProxyQueryRouteOptions } from './data-table/proxy';

package/dist/{index.es-B4p6mwaz.js → index.es-Bylk5fh-.js}

@@ -1,4 +1,4 @@
-import { _ as Xa } from "./jspdf.es.min-CpRUhh3E.js";
+import { _ as Xa } from "./jspdf.es.min-Dzm5j8wC.js";
 var Ke = typeof globalThis < "u" ? globalThis : typeof window < "u" ? window : typeof global < "u" ? global : typeof self < "u" ? self : {};
 function Do(a) {
   return a && a.__esModule && Object.prototype.hasOwnProperty.call(a, "default") ? a.default : a;