@sparqjs/schema-core 0.1.0

package/dist/ui-keys.js

@@ -0,0 +1,45 @@
+import { SCHEMA_COMPONENT_SELECT, SCHEMA_COMPONENT_SWITCH, SCHEMA_COMPONENT_TEXT, SCHEMA_COMPONENT_TEXTAREA, SCHEMA_COMPONENT_NUMBER, } from './component-keys';
+export const SCHEMA_UI_TEXT = SCHEMA_COMPONENT_TEXT;
+export const SCHEMA_UI_TEXTAREA = SCHEMA_COMPONENT_TEXTAREA;
+export const SCHEMA_UI_NUMBER = SCHEMA_COMPONENT_NUMBER;
+export const SCHEMA_UI_SELECT = SCHEMA_COMPONENT_SELECT;
+export const SCHEMA_UI_TREE_SELECT = 'treeSelect';
+export const SCHEMA_UI_CASCADER = 'cascader';
+export const SCHEMA_UI_RADIO_GROUP = 'radioGroup';
+export const SCHEMA_UI_CHECKBOX_GROUP = 'checkboxGroup';
+export const SCHEMA_UI_SWITCH = SCHEMA_COMPONENT_SWITCH;
+export const SCHEMA_UI_RATE = 'rate';
+export const SCHEMA_UI_DATE_PICKER = 'datePicker';
+export const SCHEMA_UI_TIME_PICKER = 'timePicker';
+export const SCHEMA_UI_SLIDER = 'slider';
+export const SCHEMA_UI_COLOR_PICKER = 'colorPicker';
+export const SCHEMA_UI_BUTTON = 'button';
+export const SCHEMA_UI_BUTTON_GROUP = 'buttonGroup';
+export const SCHEMA_UI_FORM = 'form';
+export const SCHEMA_UI_FORM_ITEM = 'formItem';
+export const SCHEMA_UI_TABLE = 'table';
+export const SCHEMA_UI_TABLE_COLUMN = 'tableColumn';
+export const SCHEMA_UI_TREE = 'tree';
+export const SCHEMA_UI_PAGINATION = 'pagination';
+export const SCHEMA_UI_ALERT = 'alert';
+export const SCHEMA_UI_CARD = 'card';
+export const SCHEMA_UI_TAG = 'tag';
+export const SCHEMA_UI_EMPTY = 'empty';
+export const SCHEMA_UI_CHECKBOX = 'checkbox';
+export const SCHEMA_UI_COL = 'col';
+export const SCHEMA_UI_COLLAPSE = 'collapse';
+export const SCHEMA_UI_COLLAPSE_ITEM = 'collapseItem';
+export const SCHEMA_UI_DIALOG = 'dialog';
+export const SCHEMA_UI_DIVIDER = 'divider';
+export const SCHEMA_UI_DRAWER = 'drawer';
+export const SCHEMA_UI_DROPDOWN = 'dropdown';
+export const SCHEMA_UI_DROPDOWN_ITEM = 'dropdownItem';
+export const SCHEMA_UI_DROPDOWN_MENU = 'dropdownMenu';
+export const SCHEMA_UI_OPTION = 'option';
+export const SCHEMA_UI_OPTION_GROUP = 'optionGroup';
+export const SCHEMA_UI_RADIO = 'radio';
+export const SCHEMA_UI_ROW = 'row';
+export const SCHEMA_UI_SCROLLBAR = 'scrollbar';
+export const SCHEMA_UI_TAB_PANE = 'tabPane';
+export const SCHEMA_UI_TABS = 'tabs';
+//# sourceMappingURL=ui-keys.js.map

package/dist/ui-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-keys.js","sourceRoot":"","sources":["../src/ui-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,GAC1B,MAAM,kBAAkB,CAAA;AAEzB,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAA;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAA;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAA;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAA;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAA;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAA;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAA;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAA;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAA;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAA;AACpC,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAA;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAA;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAA;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAA;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAA;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAA;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAA;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAA;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAA;AACtC,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAA;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAA;AACpC,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAA;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAA;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAA;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAA;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAA;AACtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAA;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAA;AAClC,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAA;AAC5C,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAA;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAA;AACxC,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAA;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAA;AACxC,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAA;AAC5C,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAA;AACrD,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAA;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAA;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAA;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAA;AACtC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAA;AAClC,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAA;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAA;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAA"}

package/dist/utils/condition.d.ts

@@ -0,0 +1,10 @@
+import { type Condition } from '@sparqjs/schema-protocol';
+import type { DiagnosticCollector } from '../diagnostics';
+/**
+ * 校验协议条件结构，但不执行条件。
+ *
+ * 当前 runtime 支持 field/op/value、all/any/not 和 selection_empty。
+ * expr 仍是预留协议形态，在受限表达式执行器完成前会作为诊断输出。
+ */
+export declare function validateCondition(condition: Condition | undefined, diagnostics: DiagnosticCollector, path: string): void;
+//# sourceMappingURL=condition.d.ts.map

package/dist/utils/condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../../src/utils/condition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEzD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC7B,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,WAAW,EAAE,mBAAmB,EAChC,IAAI,EAAE,MAAM,GACb,IAAI,CA0BN"}

package/dist/utils/condition.js

@@ -0,0 +1,32 @@
+import { isConditionOperator } from '@sparqjs/schema-protocol';
+/**
+ * 校验协议条件结构，但不执行条件。
+ *
+ * 当前 runtime 支持 field/op/value、all/any/not 和 selection_empty。
+ * expr 仍是预留协议形态，在受限表达式执行器完成前会作为诊断输出。
+ */
+export function validateCondition(condition, diagnostics, path) {
+    if (!condition) {
+        return;
+    }
+    if (condition.op !== undefined && !isConditionOperator(condition.op)) {
+        diagnostics.error({
+            code: 'INVALID_CONDITION_OPERATOR',
+            message: `Condition operator "${String(condition.op)}" is not supported.`,
+            path: `${path}.op`,
+            hint: 'Use one of: eq, neq, gt, gte, lt, lte, contains, in, not_in, empty, not_empty.',
+        });
+    }
+    if (condition.expr !== undefined) {
+        diagnostics.error({
+            code: 'UNSUPPORTED_CONDITION_EXPR',
+            message: 'Condition expr is reserved but not supported by the current runtime.',
+            path: `${path}.expr`,
+            hint: 'Use field/op/value or all/any/not conditions until expr execution is implemented.',
+        });
+    }
+    condition.all?.forEach((item, index) => validateCondition(item, diagnostics, `${path}.all.${index}`));
+    condition.any?.forEach((item, index) => validateCondition(item, diagnostics, `${path}.any.${index}`));
+    validateCondition(condition.not, diagnostics, `${path}.not`);
+}
+//# sourceMappingURL=condition.js.map

package/dist/utils/condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.js","sourceRoot":"","sources":["../../src/utils/condition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAkB,MAAM,0BAA0B,CAAA;AAG9E;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC7B,SAAgC,EAChC,WAAgC,EAChC,IAAY;IAEZ,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAM;IACV,CAAC;IAED,IAAI,SAAS,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;QACnE,WAAW,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,uBAAuB,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,qBAAqB;YACzE,IAAI,EAAE,GAAG,IAAI,KAAK;YAClB,IAAI,EAAE,gFAAgF;SACzF,CAAC,CAAA;IACN,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,WAAW,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,sEAAsE;YAC/E,IAAI,EAAE,GAAG,IAAI,OAAO;YACpB,IAAI,EAAE,mFAAmF;SAC5F,CAAC,CAAA;IACN,CAAC;IAED,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAA;IACrG,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAA;IACrG,iBAAiB,CAAC,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,IAAI,MAAM,CAAC,CAAA;AAChE,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 从未知错误值中提取可读消息。
+ *
+ * JavaScript 允许抛出任意值，请求库也可能抛出普通对象。该方法按常见形态提取 message，
+ * 无法提取时返回调用方提供的默认消息。
+ */
+export declare function getErrorMessage(error: unknown, defaultMessage: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAe9E"}

package/dist/utils/errors.js

@@ -0,0 +1,30 @@
+/**
+ * 从未知错误值中提取可读消息。
+ *
+ * JavaScript 允许抛出任意值，请求库也可能抛出普通对象。该方法按常见形态提取 message，
+ * 无法提取时返回调用方提供的默认消息。
+ */
+export function getErrorMessage(error, defaultMessage) {
+    if (error instanceof Error && error.message) {
+        return error.message;
+    }
+    if (typeof error === 'string' && error) {
+        return error;
+    }
+    if (hasMessage(error)) {
+        const message = String(error.message);
+        return message || defaultMessage;
+    }
+    return defaultMessage;
+}
+/**
+ * 判断未知值是否带有 message 字段。
+ */
+function hasMessage(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'message' in value &&
+        value.message !== undefined &&
+        value.message !== null);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,cAAsB;IAClE,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC,OAAO,CAAA;IACxB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,EAAE,CAAC;QACrC,OAAO,KAAK,CAAA;IAChB,CAAC;IAED,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACrC,OAAO,OAAO,IAAI,cAAc,CAAA;IACpC,CAAC;IAED,OAAO,cAAc,CAAA;AACzB,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,KAAc;IAC9B,OAAO,CACH,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QAClB,KAAK,CAAC,OAAO,KAAK,SAAS;QAC3B,KAAK,CAAC,OAAO,KAAK,IAAI,CACzB,CAAA;AACL,CAAC"}

package/dist/utils/field-generator.d.ts

@@ -0,0 +1,3 @@
+import type { ResourceField } from '@sparqjs/schema-protocol';
+export declare function fieldGeneratorRunsInFormMode(field: ResourceField, formMode: 'create' | 'edit' | undefined): boolean;
+//# sourceMappingURL=field-generator.d.ts.map

package/dist/utils/field-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-generator.d.ts","sourceRoot":"","sources":["../../src/utils/field-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAenH"}

package/dist/utils/field-generator.js

@@ -0,0 +1,16 @@
+export function fieldGeneratorRunsInFormMode(field, formMode) {
+    const generator = field.extensions?.generator;
+    if (typeof generator !== 'object' || generator === null) {
+        return false;
+    }
+    const rawOn = 'on' in generator && typeof generator.on === 'string' ? generator.on : '';
+    const on = rawOn.trim().toLowerCase() || 'create';
+    if (formMode === 'create') {
+        return on === 'create' || on === 'always';
+    }
+    if (formMode === 'edit') {
+        return on === 'update' || on === 'always';
+    }
+    return false;
+}
+//# sourceMappingURL=field-generator.js.map

package/dist/utils/field-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-generator.js","sourceRoot":"","sources":["../../src/utils/field-generator.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,4BAA4B,CAAC,KAAoB,EAAE,QAAuC;IACtG,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,EAAE,SAAS,CAAA;IAC7C,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACtD,OAAO,KAAK,CAAA;IAChB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACvF,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,QAAQ,CAAA;IACjD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,QAAQ,CAAA;IAC7C,CAAC;IACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,QAAQ,CAAA;IAC7C,CAAC;IACD,OAAO,KAAK,CAAA;AAChB,CAAC"}

package/dist/utils/field-options.d.ts

@@ -0,0 +1,7 @@
+import { type ResourceField } from '@sparqjs/schema-protocol';
+import type { DiagnosticCollector } from '../diagnostics';
+/**
+ * 按正式选项来源协议校验 ResourceField.options。
+ */
+export declare function validateFieldOptions(field: ResourceField, diagnostics: DiagnosticCollector, path: string): void;
+//# sourceMappingURL=field-options.d.ts.map

package/dist/utils/field-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-options.d.ts","sourceRoot":"","sources":["../../src/utils/field-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC1G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEzD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAuD/G"}

package/dist/utils/field-options.js

@@ -0,0 +1,65 @@
+import { isFieldOptionsMode } from '@sparqjs/schema-protocol';
+/**
+ * 按正式选项来源协议校验 ResourceField.options。
+ */
+export function validateFieldOptions(field, diagnostics, path) {
+    const options = field.options;
+    if (!options) {
+        return;
+    }
+    if (!isFieldOptionsMode(options.mode)) {
+        diagnostics.error({
+            code: 'INVALID_FIELD_OPTIONS_MODE',
+            message: `Field options mode "${String(options.mode)}" is not supported.`,
+            path: `${path}.mode`,
+            hint: 'Use one of: static, dictionary, reference, remote.',
+        });
+        return;
+    }
+    if (options.mode === 'static' && !Array.isArray(options.items)) {
+        diagnostics.error({
+            code: 'INVALID_FIELD_OPTIONS',
+            message: 'Static field options require items.',
+            path: `${path}.items`,
+            hint: 'Set options.items to an array of option items.',
+        });
+    }
+    if (options.mode === 'dictionary' && !options.dictionary?.code) {
+        diagnostics.error({
+            code: 'INVALID_FIELD_OPTIONS',
+            message: 'Dictionary field options require code.',
+            path: `${path}.dictionary.code`,
+            hint: 'Select a dictionary provided by the host Dictionary service.',
+        });
+    }
+    if (options.mode === 'reference') {
+        for (const key of ['resource', 'value_field', 'label_field']) {
+            if (!field.reference?.[key]) {
+                diagnostics.error({
+                    code: 'INVALID_FIELD_OPTIONS',
+                    message: `Reference field options require ${key}.`,
+                    path: `${path.slice(0, -'.options'.length)}.reference.${key}`,
+                    hint: `Set field.reference.${key} to a non-empty string.`,
+                });
+            }
+        }
+    }
+    if (options.mode === 'remote' && !hasRemoteOptionsSource(options.remote)) {
+        diagnostics.error({
+            code: 'INVALID_FIELD_OPTIONS',
+            message: 'Remote field options require provider or client url.',
+            path: `${path}.remote`,
+            hint: 'Set options.remote.provider for backend provider mode or options.remote.url for client mode.',
+        });
+    }
+}
+function hasRemoteOptionsSource(remote) {
+    if (!remote) {
+        return false;
+    }
+    if (remote.target === 'client') {
+        return typeof remote.url === 'string' && remote.url.trim() !== '';
+    }
+    return typeof remote.provider === 'string' && remote.provider.trim() !== '';
+}
+//# sourceMappingURL=field-options.js.map

package/dist/utils/field-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-options.js","sourceRoot":"","sources":["../../src/utils/field-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA+C,MAAM,0BAA0B,CAAA;AAG1G;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAoB,EAAE,WAAgC,EAAE,IAAY;IACrG,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAM;IACV,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,WAAW,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,uBAAuB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB;YACzE,IAAI,EAAE,GAAG,IAAI,OAAO;YACpB,IAAI,EAAE,oDAAoD;SAC7D,CAAC,CAAA;QACF,OAAM;IACV,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,WAAW,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,qCAAqC;YAC9C,IAAI,EAAE,GAAG,IAAI,QAAQ;YACrB,IAAI,EAAE,gDAAgD;SACzD,CAAC,CAAA;IACN,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;QAC7D,WAAW,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,wCAAwC;YACjD,IAAI,EAAE,GAAG,IAAI,kBAAkB;YAC/B,IAAI,EAAE,8DAA8D;SACvE,CAAC,CAAA;IACN,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,aAAa,CAAU,EAAE,CAAC;YACpE,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,WAAW,CAAC,KAAK,CAAC;oBACd,IAAI,EAAE,uBAAuB;oBAC7B,OAAO,EAAE,mCAAmC,GAAG,GAAG;oBAClD,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,cAAc,GAAG,EAAE;oBAC7D,IAAI,EAAE,uBAAuB,GAAG,yBAAyB;iBAC5D,CAAC,CAAA;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACvE,WAAW,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,sDAAsD;YAC/D,IAAI,EAAE,GAAG,IAAI,SAAS;YACtB,IAAI,EAAE,8FAA8F;SACvG,CAAC,CAAA;IACN,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAgD;IAC5E,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;IACrE,CAAC;IACD,OAAO,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;AAC/E,CAAC"}

package/dist/utils/field-validation.d.ts

@@ -0,0 +1,5 @@
+import type { ResourceField } from '@sparqjs/schema-protocol';
+import { type ExpressionContext } from '../expression';
+export declare function validateFieldValue(field: ResourceField, value: unknown, context?: ExpressionContext): string[];
+export declare function isFieldRequired(field: ResourceField, context?: ExpressionContext): boolean;
+//# sourceMappingURL=field-validation.d.ts.map

package/dist/utils/field-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-validation.d.ts","sourceRoot":"","sources":["../../src/utils/field-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAYzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,EAAE,CAuBlH;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAQ9F"}

package/dist/utils/field-validation.js

@@ -0,0 +1,206 @@
+import { evaluateCondition } from '../expression';
+import { validateRangeValue } from './range-validation';
+import { matchesValidationFormat } from './validation-format';
+import { compareValidationRuleValue, normalizeValidationIntegerValue, resolveValidationRuleValue, } from './value-expression';
+import { fieldGeneratorRunsInFormMode } from './field-generator';
+export function validateFieldValue(field, value, context = {}) {
+    const requiredMessage = validateRequiredField(field, value, context);
+    if (requiredMessage) {
+        return [requiredMessage];
+    }
+    const values = field.multiple ? toValidationItems(value) : [value];
+    const errors = [];
+    for (const item of values) {
+        if (isEmptyFieldValue(item) && !hasEnabledRangeRule(field, context)) {
+            continue;
+        }
+        for (const rule of field.validation ?? []) {
+            if (!isValidationRuleEnabled(rule, context)) {
+                continue;
+            }
+            const message = validateSingleFieldRule(field, item, rule);
+            if (message) {
+                errors.push(message);
+            }
+        }
+    }
+    return errors;
+}
+export function isFieldRequired(field, context = {}) {
+    return ((field.required === true && !fieldGeneratorRunsInFormMode(field, context.formMode)) ||
+        (field.validation?.some((rule) => normalizeRuleType(rule.type) === 'required' && isValidationRuleEnabled(rule, context)) ??
+            false));
+}
+function validateRequiredField(field, value, context) {
+    if (field.required && !fieldGeneratorRunsInFormMode(field, context.formMode) && isEmptyFieldValue(value)) {
+        return `${field.label || field.name}不能为空。`;
+    }
+    for (const rule of field.validation ?? []) {
+        if (normalizeRuleType(rule.type) !== 'required' || !isValidationRuleEnabled(rule, context)) {
+            continue;
+        }
+        if (isEmptyFieldValue(value)) {
+            return rule.message ?? `${field.label || field.name}不能为空。`;
+        }
+    }
+    return undefined;
+}
+function validateSingleFieldRule(field, value, rule) {
+    const ruleType = normalizeRuleType(rule.type);
+    switch (ruleType) {
+        case 'required':
+            return undefined;
+        case 'min_length': {
+            const min = integerRuleValue(rule);
+            return min !== undefined && runeLength(value) < min
+                ? (rule.message ?? `${field.label || field.name}长度不能小于${min}。`)
+                : undefined;
+        }
+        case 'max_length': {
+            const max = integerRuleValue(rule);
+            return max !== undefined && runeLength(value) > max
+                ? (rule.message ?? `${field.label || field.name}长度不能超过${max}。`)
+                : undefined;
+        }
+        case 'min':
+        case 'max': {
+            const boundary = resolveValidationRuleValue(rule, field);
+            if (boundary === undefined || boundary === null) {
+                return undefined;
+            }
+            const compared = compareValidationRuleValue(value, boundary);
+            if (compared === undefined) {
+                return undefined;
+            }
+            const invalid = ruleType === 'min' ? compared < 0 : compared > 0;
+            return invalid
+                ? (rule.message ??
+                    `${field.label || field.name}${ruleType === 'min' ? '不能小于' : '不能大于'}${boundary}。`)
+                : undefined;
+        }
+        case 'pattern': {
+            const pattern = stringRuleValue(rule);
+            if (!pattern) {
+                return undefined;
+            }
+            try {
+                return new RegExp(pattern).test(String(value))
+                    ? undefined
+                    : (rule.message ?? `${field.label || field.name}格式不正确。`);
+            }
+            catch {
+                return undefined;
+            }
+        }
+        case 'format':
+            return validateFormatRule(field, value, rule);
+        case 'complexity':
+            return validateComplexityRule(field, value, rule);
+        case 'range':
+            return validateRangeRule(field, value, rule);
+        default:
+            return undefined;
+    }
+}
+function validateRangeRule(field, value, rule) {
+    const issue = validateRangeValue(value, rule.params);
+    if (!issue) {
+        return undefined;
+    }
+    if (rule.message) {
+        return rule.message;
+    }
+    const label = field.label || field.name;
+    switch (issue.code) {
+        case 'params':
+            return `${label}的范围校验配置无效。`;
+        case 'shape':
+            return `${label}必须包含开始值和结束值。`;
+        case 'endpoint_format':
+            return `${label}${issue.spanUnit === 'day' ? '日期' : '时间'}格式不正确。`;
+        case 'ordered':
+            return `${label}的结束值不能早于开始值。`;
+        case 'min':
+            return `${label}不能早于允许的最小边界。`;
+        case 'max':
+            return `${label}不能晚于允许的最大边界。`;
+        case 'max_span':
+            return `${label}跨度不能超过${issue.maxSpan}${issue.spanUnit === 'day' ? '天' : '分钟'}。`;
+    }
+}
+function validateComplexityRule(field, value, rule) {
+    const stringValue = String(value);
+    const length = runeLength(stringValue);
+    const minLength = validationParamInteger(rule, 'min_length');
+    if (minLength !== undefined && length < minLength) {
+        return rule.message ?? `${field.label || field.name}长度不能小于${minLength}。`;
+    }
+    const maxLength = validationParamInteger(rule, 'max_length');
+    if (maxLength !== undefined && length > maxLength) {
+        return rule.message ?? `${field.label || field.name}长度不能超过${maxLength}。`;
+    }
+    if (validationParamBoolean(rule, 'require_lower') && !/[a-z]/.test(stringValue)) {
+        return rule.message ?? `${field.label || field.name}必须包含小写字母。`;
+    }
+    if (validationParamBoolean(rule, 'require_upper') && !/[A-Z]/.test(stringValue)) {
+        return rule.message ?? `${field.label || field.name}必须包含大写字母。`;
+    }
+    if (validationParamBoolean(rule, 'require_digit') && !/[0-9]/.test(stringValue)) {
+        return rule.message ?? `${field.label || field.name}必须包含数字。`;
+    }
+    if (validationParamBoolean(rule, 'require_symbol') && !/[^A-Za-z0-9]/.test(stringValue)) {
+        return rule.message ?? `${field.label || field.name}必须包含特殊字符。`;
+    }
+    return undefined;
+}
+function validateFormatRule(field, value, rule) {
+    const format = stringRuleValue(rule)?.toLowerCase();
+    return !format || matchesValidationFormat(format, String(value))
+        ? undefined
+        : (rule.message ?? `${field.label || field.name}格式不正确。`);
+}
+function hasEnabledRangeRule(field, context) {
+    return Boolean(field.validation?.some((rule) => normalizeRuleType(rule.type) === 'range' && isValidationRuleEnabled(rule, context)));
+}
+function isValidationRuleEnabled(rule, context) {
+    return rule.when ? evaluateCondition(rule.when, context) : true;
+}
+function normalizeRuleType(type) {
+    return String(type ?? '')
+        .trim()
+        .toLowerCase();
+}
+function integerRuleValue(rule) {
+    return normalizeValidationIntegerValue(rule.value);
+}
+function stringRuleValue(rule) {
+    if (rule.value === undefined || rule.value === null) {
+        return undefined;
+    }
+    const value = String(rule.value).trim();
+    return value === '' ? undefined : value;
+}
+function validationParamInteger(rule, key) {
+    const value = rule.params?.[key];
+    const numeric = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : Number.NaN;
+    return Number.isInteger(numeric) && numeric > 0 ? numeric : undefined;
+}
+function validationParamBoolean(rule, key) {
+    return rule.params?.[key] === true;
+}
+function runeLength(value) {
+    return Array.from(String(value)).length;
+}
+function toValidationItems(value) {
+    return Array.isArray(value) ? value : [value];
+}
+function isEmptyFieldValue(value) {
+    if (value === undefined || value === null) {
+        return true;
+    }
+    if (typeof value === 'string') {
+        return value.trim() === '';
+    }
+    return Array.isArray(value) && value.length === 0;
+}
+//# sourceMappingURL=field-validation.js.map

package/dist/utils/field-validation.js.map

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

package/dist/utils/fields.d.ts

@@ -0,0 +1,71 @@
+import type { ResourceField } from '@sparqjs/schema-protocol';
+/**
+ * 按字段 sort 升序排列。
+ *
+ * sort 缺失时按 0 处理，保持默认视图推导的排序规则集中在一个地方。
+ */
+export declare function sortFields(fields: ResourceField[]): ResourceField[];
+/**
+ * 根据字段名构建字段索引。
+ *
+ * 如果存在重名字段，后出现的字段会覆盖先出现的字段。调用方如需报错，应在构建前单独检查。
+ */
+export declare function buildFieldsByName(fields: ResourceField[]): Map<string, ResourceField>;
+/**
+ * 找出重复的字段名。
+ *
+ * 返回值只包含重复名称本身，不包含每次重复出现的位置。调用方可以据此生成协议诊断信息。
+ */
+export declare function findDuplicateFieldNames(fields: ResourceField[]): string[];
+/**
+ * 判断字段是否属于默认不展示的敏感字段。
+ *
+ * password 和 secret 默认不进入 table、search、detail 的自动推导。
+ */
+export declare function isSensitiveField(field: ResourceField): boolean;
+/**
+ * 判断字段是否声明了候选项来源。
+ *
+ * 选项能力来自字段扩展，而不是字段 type。字段 type 属于后端存储语义，前端组件推导不能把
+ * radio、select、checkbox 等字符串当作唯一依据。
+ */
+export declare function hasFieldOptions(field: ResourceField): boolean;
+/**
+ * 判断字段是否声明了可同步读取的静态选项。
+ */
+export declare function hasFieldStaticOptions(field: ResourceField): boolean;
+/**
+ * 判断字段是否支持多值。
+ *
+ * 多选组件推导只依赖字段能力开关，不依赖后端字段 type 的命名。
+ */
+export declare function isMultipleField(field: ResourceField): boolean;
+/**
+ * 判断字段是否声明了正式 relation 选项配置。
+ */
+export declare function hasFieldRelation(field: ResourceField): boolean;
+/**
+ * 判断字段是否是数值存储类型。
+ */
+export declare function isNumericField(field: ResourceField): boolean;
+/**
+ * 判断字段是否是布尔存储类型。
+ */
+export declare function isBooleanField(field: ResourceField): boolean;
+/**
+ * 判断字段是否是日期时间存储类型。
+ */
+export declare function isDateTimeField(field: ResourceField): boolean;
+/**
+ * 判断字段是否是日期存储类型。
+ */
+export declare function isDateField(field: ResourceField): boolean;
+/**
+ * 判断字段是否是时间存储类型。
+ */
+export declare function isTimeField(field: ResourceField): boolean;
+/**
+ * 判断字段是否是默认不适合搜索的复杂存储类型。
+ */
+export declare function isComplexField(field: ResourceField): boolean;
+//# sourceMappingURL=fields.d.ts.map

package/dist/utils/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/utils/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAErF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAazE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAQ9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE5D"}