openxiangda-devkit-core 2.0.0-alpha.52 → 2.0.0-alpha.53

package/dist/compiler/field-policy-path.js

@@ -0,0 +1,264 @@
+import { SCHEMA_VERSIONS, } from 'openxiangda-contracts';
+const FIELD_CODE_PATTERN = /^[A-Za-z_][A-Za-z0-9_]{0,127}$/;
+const SNAPSHOT_VALUE_TYPES = new Set([
+    'option.single',
+    'option.multiple',
+    'user.single',
+    'user.multiple',
+    'department.single',
+    'department.multiple',
+    'resource-ref.single',
+    'resource-ref.multiple',
+]);
+export const SEMANTIC_FIELD_PATH_PATTERN = /^[A-Za-z_][A-Za-z0-9_]{0,127}(?:\.(?:value|snapshot\.[A-Za-z_][A-Za-z0-9_]{0,127}))?$/;
+export function semanticFieldPathRoot(path) {
+    return path.split('.', 1)[0] || '';
+}
+export function validateAuthzSemanticBindings(input) {
+    const diagnostics = [];
+    const resources = resourceModels(input.resources);
+    const dimensions = dimensionModels(input.dimensions);
+    const policiesByCode = new Map();
+    input.policies.forEach(rawPolicy => {
+        const policy = record(rawPolicy);
+        const code = text(policy.code);
+        if (code)
+            policiesByCode.set(code, policy);
+    });
+    for (const resource of resources.values()) {
+        if (!resource.dataPolicyCode)
+            continue;
+        const policy = policiesByCode.get(resource.dataPolicyCode);
+        if (!policy || text(policy.resourceCode) !== resource.code) {
+            diagnostics.push(issue('APP_CONFIG_AUTHZ_POLICY_RESOURCE_BINDING_INVALID', `资源 ${resource.code} 的 dataPolicyCode 必须指向同一资源的策略`, `data.resources.${resource.code}.dataPolicyCode`));
+        }
+    }
+    input.policies.forEach((rawPolicy, policyIndex) => {
+        const policy = record(rawPolicy);
+        const policyPath = `authz.dataPolicies[${policyIndex}]`;
+        const policyCode = text(policy.code);
+        const resourceCode = text(policy.resourceCode);
+        const resource = resources.get(resourceCode);
+        if (!resource) {
+            diagnostics.push(issue('APP_CONFIG_AUTHZ_POLICY_RESOURCE_INVALID', '数据策略必须引用同一应用内已声明的 Data Resource', `${policyPath}.resourceCode`));
+            return;
+        }
+        if (resource.dataPolicyCode !== policyCode) {
+            diagnostics.push(issue('APP_CONFIG_AUTHZ_POLICY_RESOURCE_BINDING_INVALID', `策略 ${policyCode} 必须由资源 ${resourceCode} 的 dataPolicyCode 唯一绑定`, policyPath));
+        }
+        const rules = Array.isArray(policy.rules) ? policy.rules : [];
+        rules.forEach((rawRule, ruleIndex) => {
+            const rule = record(rawRule);
+            const rulePath = `${policyPath}.rules[${ruleIndex}]`;
+            const fieldCode = text(rule.field);
+            const field = resource.fields.get(fieldCode);
+            if (!field) {
+                diagnostics.push(issue('APP_CONFIG_AUTHZ_POLICY_FIELD_INVALID', `数据策略字段 ${fieldCode} 未在资源 ${resourceCode} 中声明`, `${rulePath}.field`));
+                return;
+            }
+            if (text(rule.subject) === 'current_user') {
+                if (!['user.single', 'user.multiple'].includes(field.type)) {
+                    diagnostics.push(issue('APP_CONFIG_AUTHZ_POLICY_CURRENT_USER_FIELD_INVALID', 'current_user 规则只能绑定 user.single 或 user.multiple 字段', `${rulePath}.field`));
+                }
+                return;
+            }
+            const dimensionCode = text(rule.dimensionCode);
+            if (dimensionCode) {
+                const dimension = dimensions.get(dimensionCode);
+                if (dimension &&
+                    !comparisonPathSupported(field, optionalText(rule.valuePath), dimension, resources)) {
+                    diagnostics.push(issue('APP_CONFIG_AUTHZ_POLICY_FIELD_PATH_INVALID', '维度策略字段和值路径与字段语义或维度类型不兼容', rule.valuePath === undefined
+                        ? `${rulePath}.field`
+                        : `${rulePath}.valuePath`));
+                }
+            }
+            const relationResourceCode = text(rule.resourceCode);
+            if (text(rule.relationCode) && !resources.has(relationResourceCode)) {
+                diagnostics.push(issue('APP_CONFIG_AUTHZ_POLICY_RELATION_RESOURCE_INVALID', 'relationship 规则必须引用同一应用内已声明的 Data Resource', `${rulePath}.resourceCode`));
+            }
+            if (text(rule.relationCode) &&
+                !genericPathSupported(field, optionalText(rule.valuePath))) {
+                diagnostics.push(issue('APP_CONFIG_AUTHZ_POLICY_FIELD_PATH_INVALID', 'relationship 规则的值路径与字段语义不兼容', rule.valuePath === undefined
+                    ? `${rulePath}.field`
+                    : `${rulePath}.valuePath`));
+            }
+        });
+    });
+    input.scopeSources.forEach((rawSource, sourceIndex) => {
+        const source = record(rawSource);
+        const sourcePath = `authz.scopeSources[${sourceIndex}]`;
+        const resource = resources.get(text(source.resourceCode));
+        if (!resource)
+            return;
+        const subjectPath = text(record(source.subject).userIdField);
+        const subject = resolveCombinedPath(resource, subjectPath);
+        if (!subject ||
+            subject.field.type !== 'user.single' ||
+            subject.valuePath !== 'value') {
+            diagnostics.push(issue('APP_CONFIG_AUTHZ_SCOPE_SOURCE_SUBJECT_PATH_INVALID', 'scope source 主体必须引用 user.single 字段的 .value', `${sourcePath}.subject.userIdField`));
+        }
+        const grants = Array.isArray(source.grants) ? source.grants : [];
+        grants.forEach((rawGrant, grantIndex) => {
+            const grant = record(rawGrant);
+            const dimension = dimensions.get(text(grant.dimensionCode));
+            for (const key of ['valueField', 'parentValueField']) {
+                if (grant[key] === undefined)
+                    continue;
+                const resolved = resolveCombinedPath(resource, text(grant[key]));
+                if (!dimension ||
+                    !resolved ||
+                    !comparisonPathSupported(resolved.field, resolved.valuePath, dimension, resources)) {
+                    diagnostics.push(issue('APP_CONFIG_AUTHZ_SCOPE_SOURCE_GRANT_PATH_INVALID', 'scope source grant 字段路径与声明维度不兼容', `${sourcePath}.grants[${grantIndex}].${key}`));
+                }
+            }
+        });
+        const typedOptionalFields = [
+            ['enabledField', new Set(['boolean'])],
+            ['effectiveFromField', new Set(['date', 'datetime'])],
+            ['effectiveToField', new Set(['date', 'datetime'])],
+        ];
+        for (const [key, allowedTypes] of typedOptionalFields) {
+            if (source[key] === undefined)
+                continue;
+            const field = resource.fields.get(text(source[key]));
+            if (!field || !allowedTypes.has(field.type)) {
+                diagnostics.push(issue('APP_CONFIG_AUTHZ_SCOPE_SOURCE_FIELD_TYPE_INVALID', `scope source 的 ${key} 字段类型不兼容`, `${sourcePath}.${key}`));
+            }
+        }
+    });
+    return diagnostics;
+}
+function comparisonPathSupported(field, valuePath, dimension, resources) {
+    if (!genericPathSupported(field, valuePath))
+        return false;
+    if (!valuePath) {
+        return dimension.valueType === 'uuid'
+            ? field.type === 'uuid'
+            : ['text.short', 'text.long', 'serial-number'].includes(field.type);
+    }
+    if (valuePath === 'value') {
+        if (dimension.valueSourceResourceCode &&
+            field.type.startsWith('resource-ref.') &&
+            field.source?.resourceCode !== dimension.valueSourceResourceCode) {
+            return false;
+        }
+        return true;
+    }
+    const snapshotField = valuePath.slice('snapshot.'.length);
+    const targetResource = resources.get(field.source?.resourceCode || '');
+    const targetType = targetResource?.fields.get(snapshotField)?.type;
+    return dimension.valueType === 'uuid'
+        ? targetType === 'uuid'
+        : ['text.short', 'text.long', 'serial-number'].includes(targetType || '');
+}
+function genericPathSupported(field, valuePath) {
+    if (!valuePath)
+        return !isJsonField(field);
+    if (valuePath === 'value')
+        return SNAPSHOT_VALUE_TYPES.has(field.type);
+    if (!valuePath.startsWith('snapshot.'))
+        return false;
+    const snapshotField = valuePath.slice('snapshot.'.length);
+    return (FIELD_CODE_PATTERN.test(snapshotField) &&
+        field.type.startsWith('resource-ref.') &&
+        Boolean(field.source?.snapshotFields?.includes(snapshotField)));
+}
+function isJsonField(field) {
+    return [
+        'option.single',
+        'option.multiple',
+        'cascade.single',
+        'cascade.multiple',
+        'user.single',
+        'user.multiple',
+        'department.single',
+        'department.multiple',
+        'resource-ref.single',
+        'resource-ref.multiple',
+        'file',
+        'image',
+        'signature',
+        'address',
+        'location',
+        'json',
+    ].includes(field.type);
+}
+function resolveCombinedPath(resource, path) {
+    if (!SEMANTIC_FIELD_PATH_PATTERN.test(path))
+        return undefined;
+    const fieldCode = semanticFieldPathRoot(path);
+    const field = resource.fields.get(fieldCode);
+    if (!field)
+        return undefined;
+    const valuePath = path.slice(fieldCode.length + 1) || undefined;
+    return { field, ...(valuePath ? { valuePath } : {}) };
+}
+function resourceModels(values) {
+    const resources = new Map();
+    values.forEach(rawResource => {
+        const resource = record(rawResource);
+        const code = text(resource.code);
+        if (!code)
+            return;
+        const schema = record(resource.schema);
+        const fields = new Map();
+        (Array.isArray(schema.fields) ? schema.fields : []).forEach(rawField => {
+            const field = record(rawField);
+            const fieldCode = text(field.code);
+            if (fieldCode)
+                fields.set(fieldCode, field);
+        });
+        resources.set(code, {
+            code,
+            ...(text(resource.dataPolicyCode)
+                ? { dataPolicyCode: text(resource.dataPolicyCode) }
+                : {}),
+            fields,
+        });
+    });
+    return resources;
+}
+function dimensionModels(values) {
+    const dimensions = new Map();
+    values.forEach(rawDimension => {
+        const dimension = record(rawDimension);
+        const code = text(dimension.code);
+        const valueType = text(dimension.valueType);
+        if (!code || !['string', 'uuid'].includes(valueType))
+            return;
+        dimensions.set(code, {
+            code,
+            valueType: valueType,
+            ...(text(record(dimension.valueSource).resourceCode)
+                ? {
+                    valueSourceResourceCode: text(record(dimension.valueSource).resourceCode),
+                }
+                : {}),
+        });
+    });
+    return dimensions;
+}
+function issue(code, message, path) {
+    return {
+        schemaVersion: SCHEMA_VERSIONS.diagnostic,
+        code,
+        severity: 'error',
+        message,
+        path,
+        source: 'openxiangda-app.config.ts',
+        retryable: false,
+    };
+}
+function record(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+function text(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function optionalText(value) {
+    const valueText = text(value);
+    return valueText || undefined;
+}
+//# sourceMappingURL=field-policy-path.js.map

package/dist/compiler/field-policy-path.js.map

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

package/dist/compiler/field-query-plan.d.ts

@@ -0,0 +1,13 @@
+import type { DataFieldType, DataQueryOperator } from 'openxiangda-contracts';
+export declare function supportsSearch(type: DataFieldType): boolean;
+export declare function supportsSort(type: DataFieldType): boolean;
+export declare function supportsFilter(type: DataFieldType): boolean;
+export declare function operatorsForField(type: DataFieldType): readonly DataQueryOperator[];
+export declare function supportsOperator(type: DataFieldType, operator: DataQueryOperator): boolean;
+export type FieldAggregateMeasure = 'countDistinct' | 'sum' | 'avg' | 'min' | 'max';
+export interface FieldAggregatePlan {
+    valueExpression: 'column' | 'snapshot-value';
+    numericResult: boolean;
+}
+export declare function aggregatePlanForField(type: DataFieldType, measure: FieldAggregateMeasure): FieldAggregatePlan | null;
+//# sourceMappingURL=field-query-plan.d.ts.map

package/dist/compiler/field-query-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-query-plan.d.ts","sourceRoot":"","sources":["../../src/compiler/field-query-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAiF/B,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,WAEjD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,WAE/C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,WAEjD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,gCAEpD;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,iBAAiB,WAG5B;AAED,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,CAAC;AAEV,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,QAAQ,GAAG,gBAAgB,CAAC;IAC7C,aAAa,EAAE,OAAO,CAAC;CACxB;AAgBD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,qBAAqB,GAC7B,kBAAkB,GAAG,IAAI,CAoB3B"}

package/dist/compiler/field-query-plan.js

@@ -0,0 +1,122 @@
+const SEARCHABLE_TYPES = new Set([
+    'text.short', 'text.long', 'text.rich', 'option.single', 'user.single',
+    'department.single', 'resource-ref.single', 'serial-number',
+]);
+const UNSORTABLE_TYPES = new Set([
+    'option.multiple', 'cascade.single', 'cascade.multiple', 'user.multiple',
+    'department.multiple', 'resource-ref.multiple', 'file', 'image', 'signature',
+    'address', 'location', 'json', 'subtable',
+]);
+const TEXT_OPERATORS = [
+    'eq', 'neq', 'contains', 'startsWith', 'endsWith', 'in', 'isEmpty',
+    'isNotEmpty',
+];
+const ORDERED_OPERATORS = [
+    'eq', 'neq', 'gt', 'gte', 'lt', 'lte', 'between', 'in', 'isEmpty',
+];
+const BOOLEAN_OPERATORS = [
+    'eq', 'neq', 'in', 'isEmpty',
+];
+const SINGLE_SNAPSHOT_OPERATORS = [
+    'eq', 'neq', 'in', 'isEmpty', 'isNotEmpty',
+];
+const MULTI_SNAPSHOT_OPERATORS = [
+    'has', 'hasAny', 'hasAll', 'isEmpty', 'isNotEmpty',
+];
+const RANGE_OPERATORS = [
+    'overlaps', 'contains', 'containedBy', 'isEmpty',
+];
+const JSON_OPERATORS = [
+    'jsonContains', 'isEmpty', 'isNotEmpty',
+];
+const EMPTY_OPERATORS = [
+    'isEmpty', 'isNotEmpty',
+];
+const UUID_OPERATORS = [
+    'eq', 'neq', 'in', 'isEmpty',
+];
+const SERIAL_OPERATORS = [
+    'eq', 'neq', 'in', 'contains', 'startsWith',
+];
+const OPERATORS_BY_TYPE = {
+    'text.short': TEXT_OPERATORS,
+    'text.long': TEXT_OPERATORS,
+    'text.rich': TEXT_OPERATORS,
+    'number.integer': ORDERED_OPERATORS,
+    'number.decimal': ORDERED_OPERATORS,
+    boolean: BOOLEAN_OPERATORS,
+    date: ORDERED_OPERATORS,
+    time: ORDERED_OPERATORS,
+    datetime: ORDERED_OPERATORS,
+    'date-range': RANGE_OPERATORS,
+    'datetime-range': RANGE_OPERATORS,
+    'option.single': SINGLE_SNAPSHOT_OPERATORS,
+    'option.multiple': MULTI_SNAPSHOT_OPERATORS,
+    'cascade.single': MULTI_SNAPSHOT_OPERATORS,
+    'cascade.multiple': MULTI_SNAPSHOT_OPERATORS,
+    'user.single': SINGLE_SNAPSHOT_OPERATORS,
+    'user.multiple': MULTI_SNAPSHOT_OPERATORS,
+    'department.single': SINGLE_SNAPSHOT_OPERATORS,
+    'department.multiple': MULTI_SNAPSHOT_OPERATORS,
+    'resource-ref.single': SINGLE_SNAPSHOT_OPERATORS,
+    'resource-ref.multiple': MULTI_SNAPSHOT_OPERATORS,
+    file: EMPTY_OPERATORS,
+    image: EMPTY_OPERATORS,
+    signature: EMPTY_OPERATORS,
+    address: JSON_OPERATORS,
+    location: JSON_OPERATORS,
+    uuid: UUID_OPERATORS,
+    json: JSON_OPERATORS,
+    'serial-number': SERIAL_OPERATORS,
+    subtable: [],
+};
+export function supportsSearch(type) {
+    return SEARCHABLE_TYPES.has(type);
+}
+export function supportsSort(type) {
+    return !UNSORTABLE_TYPES.has(type);
+}
+export function supportsFilter(type) {
+    return operatorsForField(type).length > 0;
+}
+export function operatorsForField(type) {
+    return OPERATORS_BY_TYPE[type];
+}
+export function supportsOperator(type, operator) {
+    return operatorsForField(type).includes(operator);
+}
+const AGGREGATE_NUMERIC_TYPES = new Set([
+    'number.integer', 'number.decimal',
+]);
+const AGGREGATE_ORDERED_TYPES = new Set([
+    'text.short', 'text.long', 'number.integer', 'number.decimal', 'date', 'time',
+    'datetime', 'serial-number',
+]);
+const AGGREGATE_DISTINCT_SCALAR_TYPES = new Set([
+    ...AGGREGATE_ORDERED_TYPES, 'boolean', 'uuid',
+]);
+const AGGREGATE_DISTINCT_SNAPSHOT_TYPES = new Set([
+    'option.single', 'user.single', 'department.single', 'resource-ref.single',
+]);
+export function aggregatePlanForField(type, measure) {
+    if (measure === 'sum' || measure === 'avg') {
+        return AGGREGATE_NUMERIC_TYPES.has(type)
+            ? { valueExpression: 'column', numericResult: true }
+            : null;
+    }
+    if (measure === 'min' || measure === 'max') {
+        return AGGREGATE_ORDERED_TYPES.has(type)
+            ? {
+                valueExpression: 'column',
+                numericResult: AGGREGATE_NUMERIC_TYPES.has(type),
+            }
+            : null;
+    }
+    if (AGGREGATE_DISTINCT_SNAPSHOT_TYPES.has(type)) {
+        return { valueExpression: 'snapshot-value', numericResult: true };
+    }
+    return AGGREGATE_DISTINCT_SCALAR_TYPES.has(type)
+        ? { valueExpression: 'column', numericResult: true }
+        : null;
+}
+//# sourceMappingURL=field-query-plan.js.map

package/dist/compiler/field-query-plan.js.map

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

package/dist/compiler/field-surface.d.ts

@@ -1,13 +1,13 @@
 import type { DataFieldDefinition, DataFieldSurfaceWidget } from 'openxiangda-contracts';
-export type SurfaceWidgetSource = {
-    type: DataFieldDefinition['type'];
-    reference?: DataFieldDefinition['reference'] | undefined;
-    widget?: DataFieldSurfaceWidget | undefined;
+export type SurfaceWidgetSource = Pick<DataFieldDefinition, 'type'> & {
+    widget?: DataFieldSurfaceWidget;
 };
+export declare function compatibleWidgets(type: DataFieldDefinition['type']): readonly DataFieldSurfaceWidget[];
+export declare function isCompatibleFieldWidget(field: SurfaceWidgetSource): boolean;
 /**
  * Resolve the complete presentation contract from the authored field.
  *
- * Storage type/reference remains the semantic source of truth. An explicit
+ * Semantic type remains the source of truth. An explicit
  * widget is only a presentation override; generated Surfaces must never leave
  * widget resolution to an application renderer.
  */

package/dist/compiler/field-surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-surface.d.ts","sourceRoot":"","sources":["../../src/compiler/field-surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,mBAAmB,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;IACzD,MAAM,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,mBAAmB,GACzB,sBAAsB,CAuBxB"}
+{"version":3,"file":"field-surface.d.ts","sourceRoot":"","sources":["../../src/compiler/field-surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,GAAG;IACpE,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC,CAAC;AAsCF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,qCAElE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,WAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,mBAAmB,GACzB,sBAAsB,CAGxB"}

package/dist/compiler/field-surface.js

@@ -1,34 +1,51 @@
+const WIDGETS_BY_TYPE = {
+    'text.short': ['text', 'email', 'phone'],
+    'text.long': ['textarea'],
+    'text.rich': ['rich-text'],
+    'number.integer': ['number'],
+    'number.decimal': ['number', 'money', 'percent'],
+    boolean: ['switch'],
+    date: ['date'],
+    time: ['time'],
+    datetime: ['datetime'],
+    'date-range': ['date-range'],
+    'datetime-range': ['datetime-range'],
+    'option.single': ['select', 'radio'],
+    'option.multiple': ['multi-select', 'checkbox'],
+    'cascade.single': ['cascade'],
+    'cascade.multiple': ['cascade'],
+    'user.single': ['directory-user'],
+    'user.multiple': ['directory-user'],
+    'department.single': ['directory-department', 'scope'],
+    'department.multiple': ['directory-department', 'scope'],
+    'resource-ref.single': ['select', 'radio', 'resource'],
+    'resource-ref.multiple': ['multi-select', 'checkbox', 'resource'],
+    file: ['attachment'],
+    image: ['image'],
+    signature: ['signature'],
+    address: ['address'],
+    location: ['location'],
+    uuid: ['readonly'],
+    json: ['json'],
+    'serial-number': ['readonly'],
+    subtable: ['subtable'],
+};
+export function compatibleWidgets(type) {
+    return WIDGETS_BY_TYPE[type];
+}
+export function isCompatibleFieldWidget(field) {
+    return !field.widget || compatibleWidgets(field.type).includes(field.widget);
+}
 /**
  * Resolve the complete presentation contract from the authored field.
  *
- * Storage type/reference remains the semantic source of truth. An explicit
+ * Semantic type remains the source of truth. An explicit
  * widget is only a presentation override; generated Surfaces must never leave
  * widget resolution to an application renderer.
  */
 export function resolveDataFieldSurfaceWidget(field) {
-    if (field.widget)
+    if (field.widget && isCompatibleFieldWidget(field))
         return field.widget;
-    if (field.reference)
-        return field.reference.kind;
-    switch (field.type) {
-        case 'text':
-            return 'textarea';
-        case 'integer':
-        case 'decimal':
-            return 'number';
-        case 'boolean':
-            return 'boolean';
-        case 'date':
-            return 'date';
-        case 'datetime':
-            return 'datetime';
-        case 'file':
-            return 'file';
-        case 'json':
-            return 'json';
-        case 'string':
-        case 'uuid':
-            return 'text';
-    }
+    return compatibleWidgets(field.type)[0];
 }
 //# sourceMappingURL=field-surface.js.map

package/dist/compiler/field-surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-surface.js","sourceRoot":"","sources":["../../src/compiler/field-surface.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAA0B;IAE1B,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IACtC,IAAI,KAAK,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;IACjD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,UAAU,CAAC;QACpB,KAAK,SAAS,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"field-surface.js","sourceRoot":"","sources":["../../src/compiler/field-surface.ts"],"names":[],"mappings":"AASA,MAAM,eAAe,GAGjB;IACF,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;IACxC,WAAW,EAAE,CAAC,UAAU,CAAC;IACzB,WAAW,EAAE,CAAC,WAAW,CAAC;IAC1B,gBAAgB,EAAE,CAAC,QAAQ,CAAC;IAC5B,gBAAgB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC;IAChD,OAAO,EAAE,CAAC,QAAQ,CAAC;IACnB,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,YAAY,EAAE,CAAC,YAAY,CAAC;IAC5B,gBAAgB,EAAE,CAAC,gBAAgB,CAAC;IACpC,eAAe,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;IACpC,iBAAiB,EAAE,CAAC,cAAc,EAAE,UAAU,CAAC;IAC/C,gBAAgB,EAAE,CAAC,SAAS,CAAC;IAC7B,kBAAkB,EAAE,CAAC,SAAS,CAAC;IAC/B,aAAa,EAAE,CAAC,gBAAgB,CAAC;IACjC,eAAe,EAAE,CAAC,gBAAgB,CAAC;IACnC,mBAAmB,EAAE,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACtD,qBAAqB,EAAE,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACxD,qBAAqB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC;IACtD,uBAAuB,EAAE,CAAC,cAAc,EAAE,UAAU,EAAE,UAAU,CAAC;IACjE,IAAI,EAAE,CAAC,YAAY,CAAC;IACpB,KAAK,EAAE,CAAC,OAAO,CAAC;IAChB,SAAS,EAAE,CAAC,WAAW,CAAC;IACxB,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,eAAe,EAAE,CAAC,UAAU,CAAC;IAC7B,QAAQ,EAAE,CAAC,UAAU,CAAC;CACvB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAiC;IACjE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAA0B;IAChE,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAA0B;IAE1B,IAAI,KAAK,CAAC,MAAM,IAAI,uBAAuB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IACxE,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC;AAC3C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-devkit-core",
-  "version": "2.0.0-alpha.52",
+  "version": "2.0.0-alpha.53",
   "description": "Framework-neutral OpenXiangda 2.0 workspace and control-plane use cases.",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,7 +26,7 @@
   ],
   "dependencies": {
     "cron-parser": "5.4.0",
-    "openxiangda-contracts": "2.0.0-alpha.39",
+    "openxiangda-contracts": "2.0.0-alpha.40",
     "esbuild": "0.28.2",
     "typescript": "5.9.3"
   },