{ "schemaVersion": "1.0.0", "generatedAt": "2026-06-26T01:13:35.730Z", "packageName": "@praxisui/dynamic-fields", "packageVersion": "9.0.0-beta.22", "sourceRegistry": "praxis-component-registry-ingestion", "sourceRegistryVersion": "1.0.0", "componentCount": 76, "components": { "pdx-color-input": { "id": "pdx-color-input", "description": "Campo de cor com input do Material e validação.", "inputs": [ { "name": "metadata", "type": "MaterialColorInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-color-input", "friendlyName": "Cor (input)", "icon": "palette", "tags": [ "widget", "field", "input", "material", "color" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/color-input/color-input.metadata.ts", "exportName": "PDX_COLOR_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-color-input\nSelector: pdx-color-input\nFriendly Name: Cor (input)\nDescription: Campo de cor com input do Material e validação.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, material, color\nInputs:\n - metadata (MaterialColorInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/color-input/color-input.metadata.ts", "contentHash": "2aa06f85fb57fa23ec0f998cca3e6bc3521c995557b80f46352f9c10828b829e", "sourceKind": "component_definition", "sourceId": "pdx-color-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"color\",\n \"title\": \"Color controls\",\n \"description\": \"Profile for color input and picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-color-input\",\n \"pdx-color-picker\",\n \"pdx-material-colorpicker\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Color metadata paths such as format, alpha support and palette presets.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.color.configure\",\n \"title\": \"Configure color field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"format\": {\n \"enum\": [\n \"hex\",\n \"rgb\",\n \"rgba\"\n ]\n },\n \"allowAlpha\": {\n \"type\": \"boolean\"\n },\n \"palette\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"color-format-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.format\",\n \"fieldMetadata.allowAlpha\",\n \"fieldMetadata.palette\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"color-format-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP016\",\n \"description\": \"Color values and palette entries must match the configured color format.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-color-hex-palette\",\n \"request\": \"Use hex colors and offer brand palette presets.\",\n \"operationId\": \"field.color.configure\",\n \"params\": {\n \"format\": \"hex\",\n \"allowAlpha\": false,\n \"palette\": [\n \"#0057B8\",\n \"#00A676\"\n ]\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "7c84a30ae96bf1ab1ec0733458cc04a7144bf3fe81f504227a4deb942a0fec2e", "sourceKind": "component_definition", "sourceId": "pdx-color-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-color-input | controlType: color\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-color-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"color\"\n ],\n \"useWhen\": \"criar campo color\",\n \"examplePrompts\": [\n \"crie um campo color\",\n \"adicione um color ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_color\",\n \"label\": \"Example color\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"color\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"format\": \"hex\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"color\",\n \"views\": [\n \"gradient\"\n ],\n \"activeView\": \"gradient\",\n \"preview\": true,\n \"clearButton\": true,\n \"actionsLayout\": \"start\",\n \"adaptiveMode\": true,\n \"adaptiveTitle\": \"example\",\n \"adaptiveSubtitle\": \"example\",\n \"popupSettings\": {\n \"example\": true\n },\n \"gradientSettings\": {\n \"example\": true\n },\n \"paletteSettings\": {\n \"example\": true\n },\n \"fillMode\": \"solid\",\n \"rounded\": \"none\",\n \"size\": \"small\",\n \"icon\": \"example\",\n \"iconClass\": \"example\",\n \"svgIcon\": \"example\",\n \"tabindex\": 1\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-color-input.json", "contentHash": "a45833ed15e99fe0016214361aad25f8fb51131a031b1e85eee8ad37d8382584", "sourceKind": "component_definition", "sourceId": "pdx-color-input", "corpusVersion": "1.0.0" } ] }, "pdx-color-picker": { "id": "pdx-color-picker", "description": "ColorPicker unificado com Gradient/Palette, Apply/Cancel, Clear, Adaptive e theming.", "inputs": [ { "name": "metadata", "type": "any", "required": false }, { "name": "label", "type": "string", "required": false }, { "name": "hint", "type": "string", "required": false }, { "name": "required", "type": "boolean", "required": false }, { "name": "format", "type": "'hex'|'rgb'|'rgba'|'hsl'", "required": false }, { "name": "views", "type": "Array<'gradient'|'palette'>", "required": false }, { "name": "activeView", "type": "'gradient'|'palette'", "required": false }, { "name": "preview", "type": "boolean", "required": false }, { "name": "clearButton", "type": "boolean | { enabled: boolean; icon?: string; iconColor?: string; tooltip?: string; ariaLabel?: string; showOnlyWhenFilled?: boolean }", "required": false }, { "name": "actionsLayout", "type": "'start'|'end'", "required": false }, { "name": "adaptiveMode", "type": "boolean", "required": false }, { "name": "adaptiveTitle", "type": "string", "required": false }, { "name": "adaptiveSubtitle", "type": "any", "required": false }, { "name": "popupSettings", "type": "{ width?:number|string; anchor?:Element; appendTo?:Element|ViewContainerRef }", "required": false }, { "name": "gradientSettings", "type": "{ showOpacity?: boolean; channel?: 'hsv'|'hsl' }", "required": false }, { "name": "paletteSettings", "type": "{ preset?: 'basic'|'office'|'material'|string; colors?: string[]; columns?: number }", "required": false }, { "name": "fillMode", "type": "'solid'|'flat'|'outline'", "required": false }, { "name": "rounded", "type": "'none'|'small'|'medium'|'large'|'full'", "required": false }, { "name": "size", "type": "'small'|'medium'|'large'", "required": false }, { "name": "icon", "type": "string", "required": false }, { "name": "iconClass", "type": "string|string[]|Record", "required": false }, { "name": "svgIcon", "type": "SVGIcon", "required": false }, { "name": "tabindex", "type": "number", "required": false }, { "name": "disabled", "type": "boolean", "required": false }, { "name": "readonly", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-color-picker", "friendlyName": "Color Picker v2", "icon": "palette", "tags": [ "widget", "field", "color", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/color-picker/pdx-color-picker.metadata.ts", "exportName": "PDX_COLOR_PICKER_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-color-picker\nSelector: pdx-color-picker\nFriendly Name: Color Picker v2\nDescription: ColorPicker unificado com Gradient/Palette, Apply/Cancel, Clear, Adaptive e theming.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, color, material\nInputs:\n - metadata (any)\n - label (string)\n - hint (string)\n - required (boolean)\n - format ('hex'|'rgb'|'rgba'|'hsl')\n - views (Array<'gradient'|'palette'>)\n - activeView ('gradient'|'palette')\n - preview (boolean)\n - clearButton (boolean | { enabled: boolean; icon?: string; iconColor?: string; tooltip?: string; ariaLabel?: string; showOnlyWhenFilled?: boolean })\n - actionsLayout ('start'|'end')\n - adaptiveMode (boolean)\n - adaptiveTitle (string)\n - adaptiveSubtitle (any)\n - popupSettings ({ width?:number|string; anchor?:Element; appendTo?:Element|ViewContainerRef })\n - gradientSettings ({ showOpacity?: boolean; channel?: 'hsv'|'hsl' })\n - paletteSettings ({ preset?: 'basic'|'office'|'material'|string; colors?: string[]; columns?: number })\n - fillMode ('solid'|'flat'|'outline')\n - rounded ('none'|'small'|'medium'|'large'|'full')\n - size ('small'|'medium'|'large')\n - icon (string)\n - iconClass (string|string[]|Record)\n - svgIcon (SVGIcon)\n - tabindex (number)\n - disabled (boolean)\n - readonly (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/color-picker/pdx-color-picker.metadata.ts", "contentHash": "30dd6c933cdef185b7d0d983c0ebcaec1b03a69df8dde11f16f52e85d42f9056", "sourceKind": "component_definition", "sourceId": "pdx-color-picker", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"color\",\n \"title\": \"Color controls\",\n \"description\": \"Profile for color input and picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-color-input\",\n \"pdx-color-picker\",\n \"pdx-material-colorpicker\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Color metadata paths such as format, alpha support and palette presets.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.color.configure\",\n \"title\": \"Configure color field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"format\": {\n \"enum\": [\n \"hex\",\n \"rgb\",\n \"rgba\"\n ]\n },\n \"allowAlpha\": {\n \"type\": \"boolean\"\n },\n \"palette\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"color-format-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.format\",\n \"fieldMetadata.allowAlpha\",\n \"fieldMetadata.palette\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"color-format-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP016\",\n \"description\": \"Color values and palette entries must match the configured color format.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-color-hex-palette\",\n \"request\": \"Use hex colors and offer brand palette presets.\",\n \"operationId\": \"field.color.configure\",\n \"params\": {\n \"format\": \"hex\",\n \"allowAlpha\": false,\n \"palette\": [\n \"#0057B8\",\n \"#00A676\"\n ]\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "7c84a30ae96bf1ab1ec0733458cc04a7144bf3fe81f504227a4deb942a0fec2e", "sourceKind": "component_definition", "sourceId": "pdx-color-picker", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-color-picker | controlType: colorPicker\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-color-picker\",\n \"tags\": [\n \"dynamic-fields\",\n \"color\"\n ],\n \"useWhen\": \"criar campo colorPicker\",\n \"examplePrompts\": [\n \"crie um campo colorPicker\",\n \"adicione um colorPicker ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_colorPicker\",\n \"label\": \"Example colorPicker\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"colorPicker\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"format\": \"hex\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"views\": [\n \"gradient\"\n ],\n \"activeView\": \"gradient\",\n \"preview\": true,\n \"clearButton\": true,\n \"actionsLayout\": \"start\",\n \"adaptiveMode\": true,\n \"adaptiveTitle\": \"example\",\n \"adaptiveSubtitle\": \"example\",\n \"popupSettings\": {\n \"example\": true\n },\n \"gradientSettings\": {\n \"example\": true\n },\n \"paletteSettings\": {\n \"example\": true\n },\n \"fillMode\": \"solid\",\n \"rounded\": \"none\",\n \"size\": \"small\",\n \"icon\": \"example\",\n \"iconClass\": \"example\",\n \"svgIcon\": \"example\",\n \"tabindex\": 1\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-color-picker.json", "contentHash": "27635d77d2963ed103a455e32fac0b0bfd6b9fef1fd1cb52978b2f4b43531bd8", "sourceKind": "component_definition", "sourceId": "pdx-color-picker", "corpusVersion": "1.0.0" } ] }, "pdx-date-input": { "id": "pdx-date-input", "description": "Campo de data simples (input) com validação.", "inputs": [ { "name": "metadata", "type": "MaterialDateInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-date-input", "friendlyName": "Data (input)", "icon": "calendar_today", "tags": [ "widget", "field", "input", "material", "date" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/date-input/date-input.metadata.ts", "exportName": "PDX_DATE_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-date-input\nSelector: pdx-date-input\nFriendly Name: Data (input)\nDescription: Campo de data simples (input) com validação.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, material, date\nInputs:\n - metadata (MaterialDateInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/date-input/date-input.metadata.ts", "contentHash": "260bd8d57dafd580820383dce9048dfc98b887c7772cd8a04cfd13b6f97cd25e", "sourceKind": "component_definition", "sourceId": "pdx-date-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date\",\n \"title\": \"Date controls\",\n \"description\": \"Profile for single date, datetime, month, week, year and time picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-date-input\",\n \"pdx-datetime-local-input\",\n \"pdx-inline-date\",\n \"pdx-inline-time\",\n \"pdx-material-datepicker\",\n \"pdx-material-timepicker\",\n \"pdx-month-input\",\n \"pdx-time-input\",\n \"pdx-week-input\",\n \"pdx-year-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date/time metadata paths such as min, max, timezone, locale and format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.date.configure\",\n \"title\": \"Configure date or time field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"timezone\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"temporal-bounds-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.timezone\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.format\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-min-max\",\n \"request\": \"Limit the date field to the current year in Sao Paulo timezone.\",\n \"operationId\": \"field.date.configure\",\n \"params\": {\n \"min\": \"2026-01-01\",\n \"max\": \"2026-12-31\",\n \"timezone\": \"America/Sao_Paulo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "08eab5ad75f996b139ebddd730883a5cd6895567e2c3a16cafc4ddf60e53b185", "sourceKind": "component_definition", "sourceId": "pdx-date-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-date-input | controlType: dateInput | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-date-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"date-input\"\n ],\n \"useWhen\": \"capturar data pontual com entrada nativa e baixo custo de interface\",\n \"examplePrompts\": [\n \"crie um campo dateInput para data da fatura\",\n \"adicione dateInput para data de emissão\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"invoiceDate\",\n \"label\": \"Data da fatura\",\n \"placeholder\": \"aaaa-mm-dd\",\n \"controlType\": \"dateInput\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de data da fatura\"\n },\n \"hint\": \"Use formato de data local\",\n \"minDate\": \"2024-01-01\",\n \"maxDate\": \"2026-12-31\",\n \"ariaLabel\": \"Campo de data da fatura\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-date-input.json", "contentHash": "ef15fd26f7497ce460f9d62f93a7d4469990855f873279b3cb4d3b591d4640ae", "sourceKind": "component_definition", "sourceId": "pdx-date-input", "corpusVersion": "1.0.0" } ] }, "pdx-datetime-local-input": { "id": "pdx-datetime-local-input", "description": "Campo para data e hora local com validação.", "inputs": [ { "name": "metadata", "type": "MaterialDatetimeLocalInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-datetime-local-input", "friendlyName": "Data e hora (local)", "icon": "event", "tags": [ "widget", "field", "input", "material", "datetime" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/datetime-local-input/datetime-local-input.metadata.ts", "exportName": "PDX_DATETIME_LOCAL_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-datetime-local-input\nSelector: pdx-datetime-local-input\nFriendly Name: Data e hora (local)\nDescription: Campo para data e hora local com validação.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, material, datetime\nInputs:\n - metadata (MaterialDatetimeLocalInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/datetime-local-input/datetime-local-input.metadata.ts", "contentHash": "6b72849a207859105c46c6878525cb3f5c2e7a733b29b7a9a0e577023f3d19d5", "sourceKind": "component_definition", "sourceId": "pdx-datetime-local-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date\",\n \"title\": \"Date controls\",\n \"description\": \"Profile for single date, datetime, month, week, year and time picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-date-input\",\n \"pdx-datetime-local-input\",\n \"pdx-inline-date\",\n \"pdx-inline-time\",\n \"pdx-material-datepicker\",\n \"pdx-material-timepicker\",\n \"pdx-month-input\",\n \"pdx-time-input\",\n \"pdx-week-input\",\n \"pdx-year-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date/time metadata paths such as min, max, timezone, locale and format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.date.configure\",\n \"title\": \"Configure date or time field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"timezone\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"temporal-bounds-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.timezone\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.format\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-min-max\",\n \"request\": \"Limit the date field to the current year in Sao Paulo timezone.\",\n \"operationId\": \"field.date.configure\",\n \"params\": {\n \"min\": \"2026-01-01\",\n \"max\": \"2026-12-31\",\n \"timezone\": \"America/Sao_Paulo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "08eab5ad75f996b139ebddd730883a5cd6895567e2c3a16cafc4ddf60e53b185", "sourceKind": "component_definition", "sourceId": "pdx-datetime-local-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-datetime-local-input | controlType: dateTimeLocal | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-datetime-local-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"datetime-local\"\n ],\n \"useWhen\": \"capturar data e hora no mesmo ponto de entrada\",\n \"examplePrompts\": [\n \"crie um campo dateTimeLocal para agendamento\",\n \"adicione datetime local para evento\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"appointmentAt\",\n \"label\": \"Agendamento\",\n \"placeholder\": \"aaaa-mm-ddThh:mm\",\n \"controlType\": \"dateTimeLocal\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de agendamento\"\n },\n \"hint\": \"Data e hora local do atendimento\",\n \"stepMinute\": 15,\n \"ariaLabel\": \"Campo de data e hora do agendamento\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-datetime-local-input.json", "contentHash": "76d9e8710862b7442bcb84b60550fba2d700f5739c35d9655d9a650a0b899c1f", "sourceKind": "component_definition", "sourceId": "pdx-datetime-local-input", "corpusVersion": "1.0.0" } ] }, "pdx-editable-collection": { "id": "pdx-editable-collection", "description": "praxis.dynamicFields.editorial.array.description", "category": "table", "inputs": [ { "name": "metadata", "type": "FieldMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": "FieldMetadata", "selector": "pdx-editable-collection", "friendlyName": "praxis.dynamicFields.editorial.array.friendlyName", "icon": "dynamic_form", "tags": [ "widget", "field", "array", "collection", "repeatable" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/editable-collection/editable-collection.metadata.ts", "exportName": "PDX_EDITABLE_COLLECTION_COMPONENT_METADATA", "capabilities": [ { "path": "id", "category": "identity", "valueKind": "string", "description": "Identificador unico da instancia do componente.", "intentExamples": [ "id do componente", "definir id fixo" ] }, { "path": "version", "category": "identity", "valueKind": "string", "description": "Versao do schema de metadata (migracao).", "intentExamples": [ "versao do metadata", "ajustar versao" ] }, { "path": "context", "category": "identity", "valueKind": "enum", "allowedValues": [ "form", "filter", "table", "dialog", "standalone" ], "description": "Contexto de uso do componente (form/filter/table/dialog/standalone).", "intentExamples": [ "contexto form", "usar em tabela" ] }, { "path": "createdAt", "category": "misc", "valueKind": "string", "description": "Timestamp de criacao (ISO).", "safetyNotes": "Valor de auditoria; preferir preenchimento pelo host." }, { "path": "updatedAt", "category": "misc", "valueKind": "string", "description": "Timestamp de atualizacao (ISO).", "safetyNotes": "Valor de auditoria; preferir preenchimento pelo host." }, { "path": "tags", "category": "identity", "valueKind": "array", "description": "Tags para categorizacao e busca.", "intentExamples": [ "tag para busca", "categorizar campo" ] }, { "path": "cssClass", "category": "appearance", "valueKind": "string", "description": "Classe CSS aplicada ao host do componente.", "intentExamples": [ "classe custom", "aplicar classe" ] }, { "path": "style", "category": "appearance", "valueKind": "object", "description": "Estilos inline (objeto CSS).", "safetyNotes": "Validar chaves e valores CSS permitidos." }, { "path": "dataAttributes", "category": "data", "valueKind": "object", "description": "Data attributes para teste/analytics.", "intentExamples": [ "data-testid", "atributos de tracking" ] }, { "path": "name", "category": "identity", "valueKind": "string", "description": "Identificador único do campo. Essencial para binding.", "critical": true, "intentExamples": [ "nomear campo como email", "id do campo" ] }, { "path": "label", "category": "identity", "valueKind": "string", "description": "Rótulo principal exibido para o usuário.", "intentExamples": [ "alterar label", "mudar texto do rótulo" ] }, { "path": "placeholder", "category": "identity", "valueKind": "string", "description": "Texto temporário exibido quando vazio.", "intentExamples": [ "adicionar placeholder", "texto de ajuda no input" ] }, { "path": "hint", "category": "identity", "valueKind": "string", "description": "Texto de ajuda exibido abaixo do campo.", "intentExamples": [ "colocar dica", "ajuda no rodapé do campo" ] }, { "path": "helpText", "category": "identity", "valueKind": "string", "description": "Texto semântico de ajuda publicado pelo schema/DTO.", "intentExamples": [ "explicar regra de negócio do campo", "ajuda vinda do backend" ] }, { "path": "tooltip", "category": "identity", "valueKind": "string", "description": "Texto exibido ao passar o mouse.", "intentExamples": [ "adicionar tooltip" ] }, { "path": "tooltipOnHover", "category": "identity", "valueKind": "boolean", "description": "Habilita apresentação do tooltip no hover quando suportado pelo renderer.", "intentExamples": [ "mostrar tooltip ao passar o mouse", "ativar dica no hover" ] }, { "path": "description", "category": "identity", "valueKind": "string", "description": "Descrição detalhada (usada em documentação ou helps extensos).", "intentExamples": [ "descrição completa do campo", "texto explicativo longo", "documentação do input" ] }, { "path": "selectionMode", "category": "behavior", "valueKind": "enum", "allowedValues": [ "boolean", "single", "multiple" ], "description": "Semântica de seleção explícita para controles de escolha.", "intentExamples": [ "checkbox booleano", "radio de escolha única", "grupo múltiplo" ] }, { "path": "variant", "category": "appearance", "valueKind": "string", "description": "Variante visual/semântica do controle.", "intentExamples": [ "variante consent", "modo compact", "apresentação em tiles" ] }, { "path": "density", "category": "appearance", "valueKind": "enum", "allowedValues": [ "compact", "comfortable", "spacious" ], "description": "Densidade visual do shell do controle.", "intentExamples": [ "deixar mais compacto", "usar densidade confortável", "mais espaçado" ] }, { "path": "links", "category": "identity", "valueKind": "array", "description": "Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.", "intentExamples": [ "adicionar link da política", "incluir termos de uso", "anexar link institucional" ] }, { "path": "group", "category": "identity", "valueKind": "string", "description": "Agrupador lógico do campo.", "intentExamples": [ "agrupar em Dados Pessoais", "colocar no grupo de endereço", "categoria do campo" ] }, { "path": "order", "category": "layout", "valueKind": "number", "description": "Ordem de exibição do campo.", "intentExamples": [ "mover para o final", "reordenar campo", "exibir primeiro", "posição 3" ] }, { "path": "width", "category": "layout", "valueKind": "string", "description": "Largura do campo (ex: 50%, 100px).", "intentExamples": [ "campo meia largura", "largura fixa 200px", "ocupar 50%", "width total" ] }, { "path": "isFlex", "category": "layout", "valueKind": "boolean", "description": "Se true, usa flex-grow para preencher espaço.", "intentExamples": [ "preencher espaço sobrando", "campo flexível", "expandir para caber" ] }, { "path": "controlType", "category": "behavior", "valueKind": "enum", "description": "Tipo do componente de UI (input, select, datepicker, etc).", "critical": true, "safetyNotes": "Mudar controlType pode invalidar propriedades específicas do componente anterior. Aplique o overlay de microcomponente correspondente.", "intentExamples": [ "mudar para select", "usar datepicker", "transformar em checkbox", "tipo do controle" ] }, { "path": "dataType", "category": "data", "valueKind": "enum", "description": "Tipo de dado do campo (text, number, date, etc).", "intentExamples": [ "tipo de dado numero", "campo de data" ] }, { "path": "source", "category": "data", "valueKind": "enum", "allowedValues": [ "schema", "local" ], "description": "Origem semântica do campo. Use local para campos do host que não vêm do schema backend.", "intentExamples": [ "campo local", "campo auxiliar do host", "campo que não vem do schema" ], "safetyNotes": "Não marque como local um campo que exista no schema backend; remova a semântica local quando houver colisão com campo server-backed." }, { "path": "transient", "category": "data", "valueKind": "boolean", "description": "Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.", "intentExamples": [ "campo temporário", "campo transient", "não enviar no payload", "usar apenas na UI" ], "safetyNotes": "Campos transient continuam participando de UI, validação, regras, visibilidade e valueChange; eles apenas saem do payload persistido por padrão." }, { "path": "submitPolicy", "category": "behavior", "valueKind": "enum", "allowedValues": [ "include", "omit", "includeWhenDirty" ], "description": "Política de submit para sobrescrever o padrão de campos locais/transient.", "intentExamples": [ "omitir do submit", "enviar mesmo sendo local", "enviar apenas se alterado" ], "safetyNotes": "Use omit para nunca persistir, include para enviar sempre e includeWhenDirty apenas quando o controle estiver dirty." }, { "path": "materialDesign.appearance", "category": "appearance", "valueKind": "enum", "allowedValues": [ "fill", "outline" ], "description": "Aparência do campo Material (fill/outline).", "intentExamples": [ "estilo outline", "aparência preenchida", "campo com borda" ] }, { "path": "materialDesign.color", "category": "appearance", "valueKind": "enum", "allowedValues": [ "primary", "accent", "warn" ], "description": "Tema de cor Material (primary/accent/warn).", "intentExamples": [ "cor primária", "destacar com accent" ] }, { "path": "materialDesign.floatLabel", "category": "appearance", "valueKind": "enum", "allowedValues": [ "auto", "always", "never" ], "description": "Comportamento do rótulo flutuante.", "intentExamples": [ "label sempre flutuando", "nunca flutuar label" ] }, { "path": "materialDesign.subscriptSizing", "category": "appearance", "valueKind": "enum", "allowedValues": [ "fixed", "dynamic" ], "description": "Estratégia de sizing do subscript (erros/hints)." }, { "path": "materialDesign.hideRequiredMarker", "category": "appearance", "valueKind": "boolean", "description": "Oculta o asterisco de campo obrigatório." }, { "path": "materialDesign.density", "category": "appearance", "valueKind": "enum", "allowedValues": [ "comfortable", "compact", "dense" ], "description": "Densidade do campo Material." }, { "path": "materialDesign.disableRipple", "category": "appearance", "valueKind": "boolean", "description": "Desativa ripple/ondulação em componentes Material." }, { "path": "materialDesign.customPalette", "category": "appearance", "valueKind": "object", "description": "Override de paleta (primary/accent/warn).", "safetyNotes": "Use cores válidas; validar contra o tema." }, { "path": "materialDesign.animations", "category": "appearance", "valueKind": "object", "description": "Configuração de animações (disable, duration, easing)." }, { "path": "prefixIcon", "category": "appearance", "valueKind": "string", "description": "Ícone exibido antes do valor.", "intentExamples": [ "ícone de usuário no início", "prefixar ícone", "imagem antes do texto" ] }, { "path": "suffixIcon", "category": "appearance", "valueKind": "string", "description": "Ícone exibido depois do valor.", "intentExamples": [ "ícone de busca no final", "sufixar ícone", "botão de ação no fim" ] }, { "path": "iconPosition", "category": "appearance", "valueKind": "enum", "allowedValues": [ "start", "end" ], "description": "Posição preferencial do ícone principal.", "intentExamples": [ "ícone à esquerda", "posicionar ícone no fim" ] }, { "path": "iconSize", "category": "appearance", "valueKind": "enum", "allowedValues": [ "small", "medium", "large" ], "description": "Tamanho do ícone.", "intentExamples": [ "ícone pequeno", "aumentar tamanho do ícone", "ícone grande" ] }, { "path": "iconColor", "category": "appearance", "valueKind": "string", "description": "Cor semântica ou token de cor aplicado ao ícone principal.", "intentExamples": [ "ícone em cor primária", "usar token do tema no ícone" ] }, { "path": "iconClass", "category": "appearance", "valueKind": "string", "description": "Classe CSS controlada pelo host para o ícone principal.", "intentExamples": [ "usar classe de ícone outlined", "aplicar classe corporativa" ] }, { "path": "iconStyle", "category": "appearance", "valueKind": "string", "description": "Estilo visual semântico do ícone quando o renderer suportar variações.", "intentExamples": [ "usar ícone arredondado", "aplicar estilo filled" ] }, { "path": "iconFontSize", "category": "appearance", "valueKind": "string", "description": "Tamanho tipográfico do ícone principal.", "intentExamples": [ "ícone com 18px", "ajustar tamanho do ícone" ] }, { "path": "valuePresentation", "category": "appearance", "valueKind": "object", "description": "Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.", "safetyNotes": "Preferir este contrato a formatadores legados quando a intencao for apresentacao de valor.", "intentExamples": [ "mostrar como moeda", "formatar como data longa", "exibir percentual" ] }, { "path": "presentation", "category": "appearance", "valueKind": "object", "description": "Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.", "safetyNotes": "Use apenas semantica declarativa; nao incluir CSS arbitrario, HTML, comandos ou efeitos mutaveis.", "intentExamples": [ "status com icone", "badge de pendente", "campo em tom warning" ] }, { "path": "presentation.presenter", "category": "appearance", "valueKind": "enum", "allowedValues": [ "text", "badge", "chip", "status", "iconValue", "progress", "rating", "microVisualization" ], "description": "Tipo semantico de renderizacao em modo apresentacao.", "intentExamples": [ "renderizar como status", "usar chip", "mostrar icone com valor" ] }, { "path": "presentation.tone", "category": "appearance", "valueKind": "enum", "allowedValues": [ "neutral", "info", "success", "warning", "danger" ], "description": "Tom semantico mapeado pelo consumidor para tokens de tema.", "intentExamples": [ "tom de sucesso", "tom de alerta", "tom de erro" ] }, { "path": "presentation.appearance", "category": "appearance", "valueKind": "enum", "allowedValues": [ "plain", "soft", "outlined", "filled" ], "description": "Nivel de enfase visual do apresentador.", "intentExamples": [ "status preenchido", "badge contornado", "chip suave" ] }, { "path": "presentation.icon", "category": "appearance", "valueKind": "string", "description": "Nome de icone Material Symbols usado pelo apresentador semantico.", "intentExamples": [ "icone lock", "icone payments", "icone schedule" ] }, { "path": "presentation.label", "category": "identity", "valueKind": "string", "description": "Rotulo semantico exibido por apresentadores como status, badge ou chip.", "intentExamples": [ "rotulo Bloqueado", "texto Aprovado", "status Aguardando aprovacao" ] }, { "path": "presentation.badge", "category": "appearance", "valueKind": "string", "description": "Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.", "intentExamples": [ "badge alto valor", "marcador D+35", "sinalizar revisao executiva" ] }, { "path": "presentation.valuePresentation", "category": "appearance", "valueKind": "object", "description": "Override de formatacao aplicado apenas pela superficie de apresentacao.", "safetyNotes": "Nao altera o valor real do FormControl nem o payload de submit." }, { "path": "presentation.visualization", "category": "appearance", "valueKind": "object", "description": "Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.", "safetyNotes": "Exige fallback textual e nao pode conter opcoes de ECharts, HTML, SVG bruto, CSS ou comandos.", "intentExamples": [ "micro chart de SLA", "barra empilhada em celula", "bullet chart de orcamento", "fluxo compacto de aprovacao" ] }, { "path": "presentation.visualization.kind", "category": "appearance", "valueKind": "enum", "allowedValues": [ "line", "area", "column", "comparison", "stackedBar", "radial", "harveyBall", "bullet", "delta", "processFlow" ], "description": "Tipo semantico da micro visualizacao de apresentacao.", "intentExamples": [ "comparison", "stackedBar", "bullet", "processFlow" ] }, { "path": "presentation.visualization.surface", "category": "layout", "valueKind": "enum", "allowedValues": [ "table-cell", "list-item", "object-header", "card-summary", "form-presentation" ], "description": "Superficie alvo usada para aplicar regras de densidade e fallback.", "intentExamples": [ "table-cell", "list-item", "form-presentation" ] }, { "path": "presentation.visualization.size", "category": "layout", "valueKind": "enum", "allowedValues": [ "xs", "sm", "md", "lg", "responsive" ], "description": "Tamanho semantico da micro visualizacao.", "intentExamples": [ "xs em tabela", "md em header", "responsive em card" ] }, { "path": "presentation.visualization.fallbackText", "category": "accessibility", "valueKind": "string", "description": "Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.", "safetyNotes": "Deve explicar valor, unidade, meta, tendencia ou estado quando aplicavel." }, { "path": "presentationRules", "category": "appearance", "valueKind": "array", "description": "Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.", "safetyNotes": "As regras devem produzir apenas set/effect semantico. Nao use para alterar valor, executar acao, navegar ou injetar HTML/CSS.", "intentExamples": [ "se status for BLOQUEADO, usar tone danger", "se valor maior que limite, mostrar badge de revisao" ] }, { "path": "presentationRules[].when", "category": "behavior", "valueKind": "object", "description": "Guarda Json Logic avaliada contra o contexto de apresentacao do campo.", "safetyNotes": "Use Json Logic serializavel; funcoes nao sao aceitas." }, { "path": "presentationRules[].set", "category": "appearance", "valueKind": "object", "description": "Patch semantico aplicado sobre presentation quando a guarda for verdadeira.", "safetyNotes": "Somente presenter, tone, icon, label, badge, tooltip, appearance, valuePresentation e interactions seguras." }, { "path": "mask", "category": "appearance", "valueKind": "string", "description": "Máscara de input (padrão do componente).", "intentExamples": [ "máscara de CPF", "formatar telefone", "aplicar máscara de data", "pattern visual" ] }, { "path": "format", "category": "appearance", "valueKind": "string", "description": "Formato de exibição (ex: pipes).", "intentExamples": [ "formato de data dd/mm/yyyy", "formato de moeda", "exibir como porcentagem" ] }, { "path": "validators", "category": "validation", "valueKind": "object", "description": "Objeto contendo todas as regras de validação.", "safetyNotes": "Não sobrescreva este objeto inteiramente; faça merge das propriedades.", "intentExamples": [ "adicionar validações", "regras de validação", "objeto validators" ] }, { "path": "validators.required", "category": "validation", "valueKind": "boolean", "description": "Campo obrigatório.", "intentExamples": [ "tornar obrigatório", "campo mandatório", "exigir preenchimento", "remover required" ] }, { "path": "required", "category": "validation", "valueKind": "boolean", "description": "Campo obrigatório (alias rápido do validators.required).", "intentExamples": [ "campo obrigatório", "exigir preenchimento" ] }, { "path": "validators.requiredMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para required." }, { "path": "validators.email", "category": "validation", "valueKind": "boolean", "description": "Validação de formato de e-mail.", "intentExamples": [ "validar como email", "aceitar apenas emails", "formato de correio eletrônico" ] }, { "path": "validators.emailMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para validação de email." }, { "path": "validators.minLength", "category": "validation", "valueKind": "number", "description": "Comprimento mínimo do texto.", "intentExamples": [ "mínimo de 5 caracteres", "pelo menos 3 letras", "tamanho mínimo" ] }, { "path": "validators.minLengthMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para minLength." }, { "path": "validators.maxLength", "category": "validation", "valueKind": "number", "description": "Comprimento máximo do texto.", "intentExamples": [ "máximo de 100 caracteres", "limitar tamanho", "não exceder 50 letras" ] }, { "path": "validators.maxLengthMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para maxLength." }, { "path": "validators.min", "category": "validation", "valueKind": "number", "description": "Valor numérico mínimo.", "intentExamples": [ "valor mínimo 10", "não aceitar menor que 0", "piso de valor" ] }, { "path": "validators.minMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para min." }, { "path": "validators.max", "category": "validation", "valueKind": "number", "description": "Valor numérico máximo.", "intentExamples": [ "valor máximo 100", "teto de valor", "não aceitar maior que 50" ] }, { "path": "validators.maxMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para max." }, { "path": "validators.pattern", "category": "validation", "valueKind": "string", "description": "Regex para validação.", "safetyNotes": "Cuidado com ReDoS em regex complexos.", "intentExamples": [ "validar com regex", "padrão customizado", "expressão regular" ] }, { "path": "validators.patternMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para pattern." }, { "path": "validators.cpf", "category": "validation", "valueKind": "boolean", "description": "Validador de CPF (legado)." }, { "path": "validators.cnpj", "category": "validation", "valueKind": "boolean", "description": "Validador de CNPJ (legado)." }, { "path": "validators.cpfCnpj", "category": "validation", "valueKind": "boolean", "description": "Validador automatico CPF/CNPJ (legado)." }, { "path": "validators.cnpjAlpha", "category": "validation", "valueKind": "boolean", "description": "Validador de CNPJ alfanumerico (legado)." }, { "path": "validators.cpfMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CPF." }, { "path": "validators.cnpjMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CNPJ." }, { "path": "validators.cnpjAlphaMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CNPJ alfanumerico." }, { "path": "validators.url", "category": "validation", "valueKind": "boolean", "description": "Validador de URL." }, { "path": "validators.urlMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para URL." }, { "path": "validators.minWords", "category": "validation", "valueKind": "number", "description": "Mínimo de palavras.", "intentExamples": [ "mínimo de 2 palavras", "exigir nome completo (2 palavras)" ] }, { "path": "validators.requiredChecked", "category": "validation", "valueKind": "boolean", "description": "Exige checkbox marcado (ex: termos de uso).", "intentExamples": [ "obrigar marcar checkbox", "aceitar termos é obrigatório" ] }, { "path": "validators.customValidator", "category": "validation", "valueKind": "expression", "description": "Validador customizado (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.asyncValidator", "category": "validation", "valueKind": "expression", "description": "Validador async customizado (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.matchField", "category": "validation", "valueKind": "string", "description": "Campo que deve coincidir (cross-field)." }, { "path": "validators.matchFieldMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para matchField." }, { "path": "validators.uniqueValidator", "category": "validation", "valueKind": "expression", "description": "Validador de unicidade via API (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.uniqueMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para unicidade." }, { "path": "validators.conditionalValidation", "category": "validation", "valueKind": "array", "description": "Regras de validação condicional.", "safetyNotes": "Use regras declarativas com Json Logic serializável; não gere funções aqui." }, { "path": "validators.conditionalValidation[].condition", "category": "validation", "valueKind": "expression", "description": "Condicao para aplicar validadores.", "safetyNotes": "Use Json Logic canônico avaliado sobre o root `form`." }, { "path": "validators.conditionalValidation[].validators", "category": "validation", "valueKind": "object", "description": "Conjunto de validadores aplicados quando a condicao for verdadeira." }, { "path": "validators.validationTrigger", "category": "validation", "valueKind": "enum", "allowedValues": [ "change", "blur", "submit", "immediate" ], "description": "Gatilho de validação no validator." }, { "path": "validators.validationDebounce", "category": "validation", "valueKind": "number", "description": "Debounce de validação no validator (ms)." }, { "path": "validators.showInlineErrors", "category": "validation", "valueKind": "boolean", "description": "Exibe erros inline (validator)." }, { "path": "validators.errorPosition", "category": "validation", "valueKind": "enum", "allowedValues": [ "bottom", "top", "tooltip" ], "description": "Posicao do erro (validator)." }, { "path": "validationMode", "category": "validation", "valueKind": "enum", "allowedValues": [ "immediate", "blur", "submit" ], "description": "Gatilho da validação (change/blur/submit).", "intentExamples": [ "validar ao sair do campo (blur)", "validar apenas no submit", "validação em tempo real" ] }, { "path": "debounceTime", "category": "validation", "valueKind": "number", "description": "Debounce para validação em ms.", "intentExamples": [ "aguardar para validar", "debounce de 500ms", "delay na validação" ] }, { "path": "options", "category": "data", "valueKind": "array", "description": "Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).", "intentExamples": [ "adicionar opções estáticas", "lista fixa de itens", "opções do select" ], "safetyNotes": "Respeite o formato esperado pelo controlType; prefira merge/append em vez de substituir o array inteiro." }, { "path": "endpoint", "category": "data", "valueKind": "string", "description": "URL para carregar opções remotas.", "intentExamples": [ "carregar do servidor", "buscar API", "endpoint de dados", "url das opções" ] }, { "path": "valueField", "category": "data", "valueKind": "string", "description": "Nome da propriedade de valor nas opções.", "intentExamples": [ "usar \"id\" como valor", "campo de valor das opções" ] }, { "path": "displayField", "category": "data", "valueKind": "string", "description": "Nome da propriedade de texto nas opções.", "intentExamples": [ "usar \"nome\" como texto", "exibir campo \"label\"", "campo de exibição" ] }, { "path": "filterField", "category": "data", "valueKind": "string", "description": "Campo para filtragem no backend.", "intentExamples": [ "filtrar por \"categoria\"", "campo de filtro na api" ] }, { "path": "queryParams", "category": "data", "valueKind": "object", "description": "Parâmetros fixos para a query do endpoint.", "intentExamples": [ "parâmetros extras na busca", "enviar tipo=ativo na query" ] }, { "path": "cacheDuration", "category": "data", "valueKind": "number", "description": "Duração do cache de dados em ms.", "intentExamples": [ "cachear por 5 minutos", "tempo de cache", "validade dos dados" ] }, { "path": "hidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta o campo globalmente.", "critical": true, "intentExamples": [ "ocultar campo", "esconder input", "campo invisível" ] }, { "path": "visibleIn", "category": "behavior", "valueKind": "array", "allowedValues": [ "form", "filter", "table", "dialog" ], "description": "Contextos onde o campo é visível.", "intentExamples": [ "mostrar apenas no filtro", "esconder na tabela", "visível só no form" ] }, { "path": "formHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas no formulário.", "intentExamples": [ "esconder no form", "invisível na edição" ] }, { "path": "tableHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas na tabela.", "intentExamples": [ "esconder na listagem", "não mostrar na tabela" ] }, { "path": "filterHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas no filtro.", "intentExamples": [ "esconder na busca", "remover do filtro" ] }, { "path": "dependencyFields", "category": "dependency", "valueKind": "array", "description": "Campos dos quais este campo depende.", "intentExamples": [ "depende de estado", "campo dependente", "cascata com outro campo" ] }, { "path": "conditionalRequired", "category": "dependency", "valueKind": "expression", "description": "Condição Json Logic para obrigatoriedade declarativa.", "safetyNotes": "Use Json Logic serializável; não gere função nem DSL textual.", "intentExamples": [ "obrigatório se outro campo for X", "condicionalmente requerido" ] }, { "path": "conditionalDisplay", "category": "dependency", "valueKind": "expression", "description": "Condição Json Logic para visibilidade declarativa.", "safetyNotes": "Use Json Logic serializável; não gere função nem DSL textual.", "intentExamples": [ "mostrar se checkbox marcado", "visibilidade condicional" ] }, { "path": "dependencyFilterMap", "category": "dependency", "valueKind": "object", "description": "Mapeamento de filtro baseado na dependência.", "intentExamples": [ "filtrar cidade por estado", "mapear valor da dependência" ] }, { "path": "dependencyValuePath", "category": "dependency", "valueKind": "string", "description": "Caminho no valor da dependência.", "intentExamples": [ "usar propriedade aninhada da dependência", "caminho do valor dependente" ] }, { "path": "dependencyMergeStrategy", "category": "dependency", "valueKind": "enum", "allowedValues": [ "replace", "merge" ], "description": "Estratégia de merge dos dados carregados.", "intentExamples": [ "substituir opções ao carregar", "mesclar resultados" ] }, { "path": "dependencyLoadOnChange", "category": "dependency", "valueKind": "enum", "allowedValues": [ "respectLoadOn", "immediate", "manual" ], "description": "Quando recarregar dependência.", "intentExamples": [ "recarregar assim que mudar", "recarregar manualmente", "carregar imediatamente" ] }, { "path": "resetOnDependentChange", "category": "dependency", "valueKind": "boolean", "description": "Zera valor se dependência mudar.", "intentExamples": [ "limpar se o pai mudar", "resetar valor na troca da dependência" ] }, { "path": "enableDependencyCascade", "category": "dependency", "valueKind": "boolean", "description": "Habilita/desabilita cascata nativa de dependências entre campos.", "intentExamples": [ "desativar cascata nativa", "habilitar cascata", "usar connections sem cascata" ] }, { "path": "dependencyDebounceMs", "category": "dependency", "valueKind": "number", "description": "Delay para reagir à mudança de dependência.", "intentExamples": [ "esperar para recarregar dependência", "debounce da cascata" ] }, { "path": "suppressInlineErrorsOnCascade", "category": "dependency", "valueKind": "boolean", "description": "Suprime erros inline durante cascata." }, { "path": "transformDisplayValue", "category": "transform", "valueKind": "expression", "description": "Transforma valor para exibição.", "safetyNotes": "Função não serializável.", "intentExamples": [ "formatar valor visualmente", "transformar display" ] }, { "path": "transformSaveValue", "category": "transform", "valueKind": "expression", "description": "Transforma valor para salvar.", "safetyNotes": "Função não serializável.", "intentExamples": [ "formatar valor para envio", "transformar payload" ] }, { "path": "textTransformApply", "category": "transform", "valueKind": "enum", "allowedValues": [ "displayOnly", "saveOnly", "both" ], "description": "Quando aplicar transformação de texto.", "intentExamples": [ "aplicar transformação apenas no display", "transformar ao salvar e exibir" ] }, { "path": "inlineEditing", "category": "behavior", "valueKind": "boolean", "description": "Permite edição inline (tabelas).", "intentExamples": [ "permitir edição na tabela", "editar na linha" ] }, { "path": "unique", "category": "validation", "valueKind": "boolean", "description": "Valida unicidade no backend.", "intentExamples": [ "validar se é único", "não permitir duplicados" ] }, { "path": "readOnly", "category": "behavior", "valueKind": "boolean", "description": "Campo somente leitura.", "intentExamples": [ "somente leitura", "bloquear edição", "campo readonly" ] }, { "path": "disabled", "category": "behavior", "valueKind": "boolean", "description": "Campo desabilitado.", "intentExamples": [ "desabilitar campo", "campo disabled", "cinza e bloqueado" ] }, { "path": "defaultValue", "category": "data", "valueKind": "object", "description": "Valor inicial do campo.", "safetyNotes": "Aceita tipos primitivos/objetos; respeite o controlType.", "intentExamples": [ "valor padrão", "iniciar com valor X", "default value" ] }, { "path": "ariaLabel", "category": "accessibility", "valueKind": "string", "description": "Label para leitores de tela.", "intentExamples": [ "label de acessibilidade", "texto para leitor de tela" ] }, { "path": "ariaDescribedBy", "category": "accessibility", "valueKind": "string", "description": "IDs de descrição acessível.", "intentExamples": [ "descrito pelo elemento X", "associar descrição aria" ] }, { "path": "tabIndex", "category": "accessibility", "valueKind": "number", "description": "Ordem de tabulacao para teclado.", "intentExamples": [ "tabindex 0", "ordem de foco" ] }, { "path": "accessKey", "category": "accessibility", "valueKind": "string", "description": "Atalho de teclado (accessKey).", "intentExamples": [ "atalho de teclado", "tecla de acesso rapido" ] } ], "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-editable-collection\nSelector: pdx-editable-collection\nFriendly Name: praxis.dynamicFields.editorial.array.friendlyName\nDescription: praxis.dynamicFields.editorial.array.description\nCategory: table\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, array, collection, repeatable\nInputs:\n - metadata (FieldMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/editable-collection/editable-collection.metadata.ts", "contentHash": "61e8f130784b3d74965c77007b7f59d70af97d1205297704a9e8d765f42b9c76", "sourceKind": "component_definition", "sourceId": "pdx-editable-collection", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "capabilities", "content": "Schema Capabilities:\n - Path: id\n Category: identity\n Kind: string\n Description: Identificador unico da instancia do componente.\n - Path: version\n Category: identity\n Kind: string\n Description: Versao do schema de metadata (migracao).\n - Path: context\n Category: identity\n Kind: enum\n Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n - Path: createdAt\n Category: misc\n Kind: string\n Description: Timestamp de criacao (ISO).\n - Path: updatedAt\n Category: misc\n Kind: string\n Description: Timestamp de atualizacao (ISO).\n - Path: tags\n Category: identity\n Kind: array\n Description: Tags para categorizacao e busca.\n - Path: cssClass\n Category: appearance\n Kind: string\n Description: Classe CSS aplicada ao host do componente.\n - Path: style\n Category: appearance\n Kind: object\n Description: Estilos inline (objeto CSS).\n - Path: dataAttributes\n Category: data\n Kind: object\n Description: Data attributes para teste/analytics.\n - Path: name\n Category: identity\n Kind: string\n Description: Identificador único do campo. Essencial para binding.\n - Path: label\n Category: identity\n Kind: string\n Description: Rótulo principal exibido para o usuário.\n - Path: placeholder\n Category: identity\n Kind: string\n Description: Texto temporário exibido quando vazio.\n - Path: hint\n Category: identity\n Kind: string\n Description: Texto de ajuda exibido abaixo do campo.\n - Path: helpText\n Category: identity\n Kind: string\n Description: Texto semântico de ajuda publicado pelo schema/DTO.\n - Path: tooltip\n Category: identity\n Kind: string\n Description: Texto exibido ao passar o mouse.\n - Path: tooltipOnHover\n Category: identity\n Kind: boolean\n Description: Habilita apresentação do tooltip no hover quando suportado pelo renderer.\n - Path: description\n Category: identity\n Kind: string\n Description: Descrição detalhada (usada em documentação ou helps extensos).\n - Path: selectionMode\n Category: behavior\n Kind: enum\n Description: Semântica de seleção explícita para controles de escolha.\n - Path: variant\n Category: appearance\n Kind: string\n Description: Variante visual/semântica do controle.\n - Path: density\n Category: appearance\n Kind: enum\n Description: Densidade visual do shell do controle.\n - Path: links\n Category: identity\n Kind: array\n Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n - Path: group\n Category: identity\n Kind: string\n Description: Agrupador lógico do campo.\n - Path: order\n Category: layout\n Kind: number\n Description: Ordem de exibição do campo.\n - Path: width\n Category: layout\n Kind: string\n Description: Largura do campo (ex: 50%, 100px).\n - Path: isFlex\n Category: layout\n Kind: boolean\n Description: Se true, usa flex-grow para preencher espaço.\n - Path: controlType\n Category: behavior\n Kind: enum\n Description: Tipo do componente de UI (input, select, datepicker, etc).\n - Path: dataType\n Category: data\n Kind: enum\n Description: Tipo de dado do campo (text, number, date, etc).\n - Path: source\n Category: data\n Kind: enum\n Description: Origem semântica do campo. Use local para campos do host que não vêm do schema backend.\n - Path: transient\n Category: data\n Kind: boolean\n Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n - Path: submitPolicy\n Category: behavior\n Kind: enum\n Description: Política de submit para sobrescrever o padrão de campos locais/transient.\n - Path: materialDesign.appearance\n Category: appearance\n Kind: enum\n Description: Aparência do campo Material (fill/outline).\n - Path: materialDesign.color\n Category: appearance\n Kind: enum\n Description: Tema de cor Material (primary/accent/warn).\n - Path: materialDesign.floatLabel\n Category: appearance\n Kind: enum\n Description: Comportamento do rótulo flutuante.\n - Path: materialDesign.subscriptSizing\n Category: appearance\n Kind: enum\n Description: Estratégia de sizing do subscript (erros/hints).\n - Path: materialDesign.hideRequiredMarker\n Category: appearance\n Kind: boolean\n Description: Oculta o asterisco de campo obrigatório.\n - Path: materialDesign.density\n Category: appearance\n Kind: enum\n Description: Densidade do campo Material.\n - Path: materialDesign.disableRipple\n Category: appearance\n Kind: boolean\n Description: Desativa ripple/ondulação em componentes Material.\n - Path: materialDesign.customPalette\n Category: appearance\n Kind: object\n Description: Override de paleta (primary/accent/warn).\n - Path: materialDesign.animations\n Category: appearance\n Kind: object\n Description: Configuração de animações (disable, duration, easing).\n - Path: prefixIcon\n Category: appearance\n Kind: string\n Description: Ícone exibido antes do valor.\n - Path: suffixIcon\n Category: appearance\n Kind: string\n Description: Ícone exibido depois do valor.\n - Path: iconPosition\n Category: appearance\n Kind: enum\n Description: Posição preferencial do ícone principal.\n - Path: iconSize\n Category: appearance\n Kind: enum\n Description: Tamanho do ícone.\n - Path: iconColor\n Category: appearance\n Kind: string\n Description: Cor semântica ou token de cor aplicado ao ícone principal.\n - Path: iconClass\n Category: appearance\n Kind: string\n Description: Classe CSS controlada pelo host para o ícone principal.\n - Path: iconStyle\n Category: appearance\n Kind: string\n Description: Estilo visual semântico do ícone quando o renderer suportar variações.\n - Path: iconFontSize\n Category: appearance\n Kind: string\n Description: Tamanho tipográfico do ícone principal.\n - Path: valuePresentation\n Category: appearance\n Kind: object\n Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n - Path: presentation\n Category: appearance\n Kind: object\n Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n - Path: presentation.presenter\n Category: appearance\n Kind: enum\n Description: Tipo semantico de renderizacao em modo apresentacao.\n - Path: presentation.tone\n Category: appearance\n Kind: enum\n Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n - Path: presentation.appearance\n Category: appearance\n Kind: enum\n Description: Nivel de enfase visual do apresentador.\n - Path: presentation.icon\n Category: appearance\n Kind: string\n Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n - Path: presentation.label\n Category: identity\n Kind: string\n Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n - Path: presentation.badge\n Category: appearance\n Kind: string\n Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n - Path: presentation.valuePresentation\n Category: appearance\n Kind: object\n Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n - Path: presentation.visualization\n Category: appearance\n Kind: object\n Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n - Path: presentation.visualization.kind\n Category: appearance\n Kind: enum\n Description: Tipo semantico da micro visualizacao de apresentacao.\n - Path: presentation.visualization.surface\n Category: layout\n Kind: enum\n Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n - Path: presentation.visualization.size\n Category: layout\n Kind: enum\n Description: Tamanho semantico da micro visualizacao.\n - Path: presentation.visualization.fallbackText\n Category: accessibility\n Kind: string\n Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n - Path: presentationRules\n Category: appearance\n Kind: array\n Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n - Path: presentationRules[].when\n Category: behavior\n Kind: object\n Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n - Path: presentationRules[].set\n Category: appearance\n Kind: object\n Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\n - Path: mask\n Category: appearance\n Kind: string\n Description: Máscara de input (padrão do componente).\n - Path: format\n Category: appearance\n Kind: string\n Description: Formato de exibição (ex: pipes).\n - Path: validators\n Category: validation\n Kind: object\n Description: Objeto contendo todas as regras de validação.\n - Path: validators.required\n Category: validation\n Kind: boolean\n Description: Campo obrigatório.\n - Path: required\n Category: validation\n Kind: boolean\n Description: Campo obrigatório (alias rápido do validators.required).\n - Path: validators.requiredMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para required.\n - Path: validators.email\n Category: validation\n Kind: boolean\n Description: Validação de formato de e-mail.\n - Path: validators.emailMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para validação de email.\n - Path: validators.minLength\n Category: validation\n Kind: number\n Description: Comprimento mínimo do texto.\n - Path: validators.minLengthMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para minLength.\n - Path: validators.maxLength\n Category: validation\n Kind: number\n Description: Comprimento máximo do texto.\n - Path: validators.maxLengthMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para maxLength.\n - Path: validators.min\n Category: validation\n Kind: number\n Description: Valor numérico mínimo.\n - Path: validators.minMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para min.\n - Path: validators.max\n Category: validation\n Kind: number\n Description: Valor numérico máximo.\n - Path: validators.maxMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para max.\n - Path: validators.pattern\n Category: validation\n Kind: string\n Description: Regex para validação.\n - Path: validators.patternMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para pattern.\n - Path: validators.cpf\n Category: validation\n Kind: boolean\n Description: Validador de CPF (legado).\n - Path: validators.cnpj\n Category: validation\n Kind: boolean\n Description: Validador de CNPJ (legado).\n - Path: validators.cpfCnpj\n Category: validation\n Kind: boolean\n Description: Validador automatico CPF/CNPJ (legado).\n - Path: validators.cnpjAlpha\n Category: validation\n Kind: boolean\n Description: Validador de CNPJ alfanumerico (legado).\n - Path: validators.cpfMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CPF.\n - Path: validators.cnpjMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CNPJ.\n - Path: validators.cnpjAlphaMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CNPJ alfanumerico.\n - Path: validators.url\n Category: validation\n Kind: boolean\n Description: Validador de URL.\n - Path: validators.urlMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para URL.\n - Path: validators.minWords\n Category: validation\n Kind: number\n Description: Mínimo de palavras.\n - Path: validators.requiredChecked\n Category: validation\n Kind: boolean\n Description: Exige checkbox marcado (ex: termos de uso).\n - Path: validators.customValidator\n Category: validation\n Kind: expression\n Description: Validador customizado (função).\n - Path: validators.asyncValidator\n Category: validation\n Kind: expression\n Description: Validador async customizado (função).\n - Path: validators.matchField\n Category: validation\n Kind: string\n Description: Campo que deve coincidir (cross-field).\n - Path: validators.matchFieldMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para matchField.\n - Path: validators.uniqueValidator\n Category: validation\n Kind: expression\n Description: Validador de unicidade via API (função).\n - Path: validators.uniqueMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para unicidade.\n - Path: validators.conditionalValidation\n Category: validation\n Kind: array\n Description: Regras de validação condicional.\n - Path: validators.conditionalValidation[].condition\n Category: validation\n Kind: expression\n Description: Condicao para aplicar validadores.\n - Path: validators.conditionalValidation[].validators\n Category: validation\n Kind: object\n Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n - Path: validators.validationTrigger\n Category: validation\n Kind: enum\n Description: Gatilho de validação no validator.\n - Path: validators.validationDebounce\n Category: validation\n Kind: number\n Description: Debounce de validação no validator (ms).\n - Path: validators.showInlineErrors\n Category: validation\n Kind: boolean\n Description: Exibe erros inline (validator).\n - Path: validators.errorPosition\n Category: validation\n Kind: enum\n Description: Posicao do erro (validator).\n - Path: validationMode\n Category: validation\n Kind: enum\n Description: Gatilho da validação (change/blur/submit).\n - Path: debounceTime\n Category: validation\n Kind: number\n Description: Debounce para validação em ms.\n - Path: options\n Category: data\n Kind: array\n Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n - Path: endpoint\n Category: data\n Kind: string\n Description: URL para carregar opções remotas.\n - Path: valueField\n Category: data\n Kind: string\n Description: Nome da propriedade de valor nas opções.\n - Path: displayField\n Category: data\n Kind: string\n Description: Nome da propriedade de texto nas opções.\n - Path: filterField\n Category: data\n Kind: string\n Description: Campo para filtragem no backend.\n - Path: queryParams\n Category: data\n Kind: object\n Description: Parâmetros fixos para a query do endpoint.\n - Path: cacheDuration\n Category: data\n Kind: number\n Description: Duração do cache de dados em ms.\n - Path: hidden\n Category: behavior\n Kind: boolean\n Description: Oculta o campo globalmente.\n - Path: visibleIn\n Category: behavior\n Kind: array\n Description: Contextos onde o campo é visível.\n - Path: formHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas no formulário.\n - Path: tableHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas na tabela.\n - Path: filterHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas no filtro.\n - Path: dependencyFields\n Category: dependency\n Kind: array\n Description: Campos dos quais este campo depende.\n - Path: conditionalRequired\n Category: dependency\n Kind: expression\n Description: Condição Json Logic para obrigatoriedade declarativa.\n - Path: conditionalDisplay\n Category: dependency\n Kind: expression\n Description: Condição Json Logic para visibilidade declarativa.\n - Path: dependencyFilterMap\n Category: dependency\n Kind: object\n Description: Mapeamento de filtro baseado na dependência.\n - Path: dependencyValuePath\n Category: dependency\n Kind: string\n Description: Caminho no valor da dependência.\n - Path: dependencyMergeStrategy\n Category: dependency\n Kind: enum\n Description: Estratégia de merge dos dados carregados.\n - Path: dependencyLoadOnChange\n Category: dependency\n Kind: enum\n Description: Quando recarregar dependência.\n - Path: resetOnDependentChange\n Category: dependency\n Kind: boolean\n Description: Zera valor se dependência mudar.\n - Path: enableDependencyCascade\n Category: dependency\n Kind: boolean\n Description: Habilita/desabilita cascata nativa de dependências entre campos.\n - Path: dependencyDebounceMs\n Category: dependency\n Kind: number\n Description: Delay para reagir à mudança de dependência.\n - Path: suppressInlineErrorsOnCascade\n Category: dependency\n Kind: boolean\n Description: Suprime erros inline durante cascata.\n - Path: transformDisplayValue\n Category: transform\n Kind: expression\n Description: Transforma valor para exibição.\n - Path: transformSaveValue\n Category: transform\n Kind: expression\n Description: Transforma valor para salvar.\n - Path: textTransformApply\n Category: transform\n Kind: enum\n Description: Quando aplicar transformação de texto.\n - Path: inlineEditing\n Category: behavior\n Kind: boolean\n Description: Permite edição inline (tabelas).\n - Path: unique\n Category: validation\n Kind: boolean\n Description: Valida unicidade no backend.\n - Path: readOnly\n Category: behavior\n Kind: boolean\n Description: Campo somente leitura.\n - Path: disabled\n Category: behavior\n Kind: boolean\n Description: Campo desabilitado.\n - Path: defaultValue\n Category: data\n Kind: object\n Description: Valor inicial do campo.\n - Path: ariaLabel\n Category: accessibility\n Kind: string\n Description: Label para leitores de tela.\n - Path: ariaDescribedBy\n Category: accessibility\n Kind: string\n Description: IDs de descrição acessível.\n - Path: tabIndex\n Category: accessibility\n Kind: number\n Description: Ordem de tabulacao para teclado.\n - Path: accessKey\n Category: accessibility\n Kind: string\n Description: Atalho de teclado (accessKey).\n", "sourcePointer": "praxis-ui-angular/projects/praxis-core/src/lib/ai/field-metadata-ai-capabilities.ts", "contentHash": "466e427814fe510e5b0108e418a13f828b5a363d3da46bf9b69be588c7088ce2", "sourceKind": "component_definition", "sourceId": "pdx-editable-collection", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"collection\",\n \"title\": \"Collection controls\",\n \"description\": \"Profile for repeatable collection controls that manage array-shaped field values.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-editable-collection\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.collection.configure\",\n \"title\": \"Configure collection field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"itemSchema\": {\n \"type\": \"object\"\n },\n \"minItems\": {\n \"type\": \"number\"\n },\n \"maxItems\": {\n \"type\": \"number\"\n },\n \"ordered\": {\n \"type\": \"boolean\"\n },\n \"allowAdd\": {\n \"type\": \"boolean\"\n },\n \"allowRemove\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"collection-item-schema-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.itemSchema\",\n \"fieldMetadata.minItems\",\n \"fieldMetadata.maxItems\",\n \"fieldMetadata.ordered\",\n \"fieldMetadata.allowAdd\",\n \"fieldMetadata.allowRemove\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"collection-item-schema-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP022\",\n \"description\": \"Collection controls require array-compatible item schema and stable item identity semantics.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-repeatable-addresses\",\n \"request\": \"Configure a repeatable address collection with at least one item.\",\n \"operationId\": \"field.collection.configure\",\n \"params\": {\n \"minItems\": 1,\n \"ordered\": true,\n \"allowAdd\": true,\n \"allowRemove\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "a96bf7f9bf98ff7c7e16496a62e2c253b3f065f56e5db79263d3729088fda790", "sourceKind": "component_definition", "sourceId": "pdx-editable-collection", "corpusVersion": "1.0.0" } ] }, "pdx-email-input": { "id": "pdx-email-input", "description": "Campo de e-mail com validação e sugestões de autocomplete.", "inputs": [ { "name": "metadata", "type": "MaterialEmailInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-email-input", "friendlyName": "E-mail (input)", "icon": "alternate_email", "tags": [ "widget", "field", "input", "material", "email" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/email-input/email-input.metadata.ts", "exportName": "PDX_EMAIL_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-email-input\nSelector: pdx-email-input\nFriendly Name: E-mail (input)\nDescription: Campo de e-mail com validação e sugestões de autocomplete.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, material, email\nInputs:\n - metadata (MaterialEmailInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/email-input/email-input.metadata.ts", "contentHash": "a5cdcd5cfecc8c3ff88117f9e5bcdef7c4a9394851705f0de961ed0257c1ebc3", "sourceKind": "component_definition", "sourceId": "pdx-email-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"text-input\",\n \"title\": \"Text input controls\",\n \"description\": \"Profile for text-like controls, including inline and Material text inputs.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-email-input\",\n \"pdx-inline-input\",\n \"pdx-inline-phone\",\n \"pdx-material-textarea\",\n \"pdx-password-input\",\n \"pdx-phone-input\",\n \"pdx-search-input\",\n \"pdx-text-input\",\n \"pdx-url-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.text.configure\",\n \"title\": \"Configure text field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"placeholder\": {\n \"type\": \"string\"\n },\n \"minLength\": {\n \"type\": \"number\"\n },\n \"maxLength\": {\n \"type\": \"number\"\n },\n \"pattern\": {\n \"type\": \"string\"\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"autocomplete\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"text-metadata-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.placeholder\",\n \"fieldMetadata.minLength\",\n \"fieldMetadata.maxLength\",\n \"fieldMetadata.pattern\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.autocomplete\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"text-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP001\",\n \"description\": \"Text constraints must preserve string field semantics and editor/runtime round-trip.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-text-placeholder-and-length\",\n \"request\": \"Set placeholder and maximum length for a text input.\",\n \"operationId\": \"field.text.configure\",\n \"params\": {\n \"placeholder\": \"Search by name\",\n \"maxLength\": 120\n },\n \"isPositive\": true\n }\n ],\n \"roundTripRequirements\": [\n \"Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state.\"\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "c0029e40a022738aabac65b76da38df2467c0f2c2e2e743baebc4841554e762b", "sourceKind": "component_definition", "sourceId": "pdx-email-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-email-input | controlType: email\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-email-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo email\",\n \"examplePrompts\": [\n \"crie um campo email\",\n \"adicione um email ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_email\",\n \"label\": \"Example email\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"email\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"email\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-email-input.json", "contentHash": "0651759918052a540c56fdb2674bc980c301f144303dc203460dc31c1ab6acba", "sourceKind": "component_definition", "sourceId": "pdx-email-input", "corpusVersion": "1.0.0" } ] }, "pdx-entity-lookup": { "id": "pdx-entity-lookup", "description": "praxis.dynamicFields.editorial.entityLookup.description", "inputs": [ { "name": "metadata", "type": "MaterialEntityLookupMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-entity-lookup", "friendlyName": "praxis.dynamicFields.editorial.entityLookup.friendlyName", "icon": "manage_search", "tags": [ "widget", "field", "entity-lookup", "option-source", "resource-entity" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-entity-lookup/inline-entity-lookup.metadata.ts", "exportName": "PDX_ENTITY_LOOKUP_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-entity-lookup\nSelector: pdx-inline-entity-lookup\nFriendly Name: praxis.dynamicFields.editorial.entityLookup.friendlyName\nDescription: praxis.dynamicFields.editorial.entityLookup.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, entity-lookup, option-source, resource-entity\nInputs:\n - metadata (MaterialEntityLookupMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-entity-lookup/inline-entity-lookup.metadata.ts", "contentHash": "92531bfeb975738e298ef63a9b2a69a104967b4ab0d8042077b6322f32eab0eb", "sourceKind": "component_definition", "sourceId": "pdx-entity-lookup", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"entity-lookup\",\n \"title\": \"Entity lookup controls\",\n \"description\": \"Profile for entity lookup controls that bind to remote resources.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-entity-lookup\",\n \"pdx-inline-entity-lookup\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Entity lookup metadata paths such as resourcePath, value/display fields and search behavior.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.entityLookup.configure\",\n \"title\": \"Configure entity lookup field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"resourcePath\": {\n \"type\": \"string\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"entity-resource-binding-valid\",\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.resourcePath\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.searchable\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"entity-resource-binding-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP007\",\n \"description\": \"Entity lookup controls require canonical resource binding and stable value/display identity fields.\"\n },\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-entity-lookup\",\n \"request\": \"Bind the entity lookup to users and show the name while storing the id.\",\n \"operationId\": \"field.entityLookup.configure\",\n \"params\": {\n \"optionSource\": {\n \"key\": \"user\",\n \"type\": \"RESOURCE_ENTITY\",\n \"resourcePath\": \"/users\",\n \"valuePropertyPath\": \"id\",\n \"labelPropertyPath\": \"name\",\n \"includeIds\": false,\n \"capabilities\": {\n \"filter\": true,\n \"byIds\": true\n },\n \"dependsOn\": [\n \"companyId\"\n ],\n \"dependencyFilterMap\": {\n \"companyId\": \"companyId\"\n }\n },\n \"valueField\": \"id\",\n \"displayField\": \"name\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e76489ec518e3317d14083f6045902aaa23b59c678244e8ad0b93b62f3ec12e7", "sourceKind": "component_definition", "sourceId": "pdx-entity-lookup", "corpusVersion": "1.0.0" } ] }, "pdx-inline-async-select": { "id": "pdx-inline-async-select", "description": "Select assíncrono compacto para barras de filtro, com busca remota, paginação e cursor.", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-async-select", "friendlyName": "Inline Async Select", "icon": "manage_search", "tags": [ "widget", "field", "async-select", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-async-select/inline-async-select.metadata.ts", "exportName": "PDX_INLINE_ASYNC_SELECT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-async-select\nSelector: pdx-inline-async-select\nFriendly Name: Inline Async Select\nDescription: Select assíncrono compacto para barras de filtro, com busca remota, paginação e cursor.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, async-select, filter, inline\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-async-select/inline-async-select.metadata.ts", "contentHash": "46f539d557a18b18827da6dea2d1fbce002b5c83110eaa4e927ec1c939637467", "sourceKind": "component_definition", "sourceId": "pdx-inline-async-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-inline-async-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-async-select | controlType: inlineAsyncSelect | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-async-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"async-select\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por catálogo remoto com carregamento sob demanda\",\n \"examplePrompts\": [\n \"crie um filtro inline remoto de equipe\",\n \"adicione inlineAsyncSelect para lookup remoto\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"teamId\",\n \"label\": \"Equipe\",\n \"placeholder\": \"Buscar equipe\",\n \"controlType\": \"inlineAsyncSelect\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de equipe\"\n },\n \"resourcePath\": \"/api/options/teams\",\n \"loadOn\": \"focus\",\n \"optionLabelKey\": \"name\",\n \"optionValueKey\": \"id\",\n \"filterField\": \"name\",\n \"queryParams\": {\n \"active\": true\n },\n \"emptyOptionText\": \"Todas as equipes\",\n \"ariaLabel\": \"Filtro remoto de equipe\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-async-select.json", "contentHash": "79b548502a73731d518958bb8499255d0e3635ffe6c60ffe854716ffd4096a65", "sourceKind": "component_definition", "sourceId": "pdx-inline-async-select", "corpusVersion": "1.0.0" } ] }, "pdx-inline-autocomplete": { "id": "pdx-inline-autocomplete", "description": "Autocomplete compacto para barra de filtro, com busca incremental, paginação e visual em pill.", "inputs": [ { "name": "metadata", "type": "MaterialAutocompleteMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-autocomplete", "friendlyName": "Inline Autocomplete", "icon": "search", "tags": [ "widget", "field", "autocomplete", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-autocomplete/inline-autocomplete.metadata.ts", "exportName": "PDX_INLINE_AUTOCOMPLETE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-autocomplete\nSelector: pdx-inline-autocomplete\nFriendly Name: Inline Autocomplete\nDescription: Autocomplete compacto para barra de filtro, com busca incremental, paginação e visual em pill.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, autocomplete, filter, inline\nInputs:\n - metadata (MaterialAutocompleteMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-autocomplete/inline-autocomplete.metadata.ts", "contentHash": "0a6327fa160617e3b625b86ff2644d3b220f3e941541258311cf144e17092383", "sourceKind": "component_definition", "sourceId": "pdx-inline-autocomplete", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-inline-autocomplete", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-autocomplete | controlType: inlineAutocomplete | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-autocomplete\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"autocomplete\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por termos conhecidos com sugestao incremental\",\n \"examplePrompts\": [\n \"crie um filtro inline com autocomplete de cidade\",\n \"adicione inlineAutocomplete para localidade\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"city\",\n \"label\": \"Cidade\",\n \"placeholder\": \"Digite para sugerir\",\n \"controlType\": \"inlineAutocomplete\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de cidade\"\n },\n \"options\": [\n {\n \"key\": \"Sao Paulo\",\n \"value\": \"sao-paulo\"\n },\n {\n \"key\": \"Rio de Janeiro\",\n \"value\": \"rio-de-janeiro\"\n },\n {\n \"key\": \"Belo Horizonte\",\n \"value\": \"belo-horizonte\"\n },\n {\n \"key\": \"Curitiba\",\n \"value\": \"curitiba\"\n }\n ],\n \"searchable\": true,\n \"debounceTime\": 200,\n \"ariaLabel\": \"Filtro com autocomplete de cidade\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-autocomplete.json", "contentHash": "d5b2674631f78d378692477da36ca0ae8578c1cbdce3f07c4372af6013afba60", "sourceKind": "component_definition", "sourceId": "pdx-inline-autocomplete", "corpusVersion": "1.0.0" } ] }, "pdx-inline-color-label": { "id": "pdx-inline-color-label", "description": "Filtro inline de cor/label com grid de cores, seleção visual e badges removíveis.", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-color-label", "friendlyName": "Inline Color Label", "icon": "palette", "tags": [ "widget", "field", "color", "label", "filter", "inline", "multiselect" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-color-label/inline-color-label.metadata.ts", "exportName": "PDX_INLINE_COLOR_LABEL_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-color-label\nSelector: pdx-inline-color-label\nFriendly Name: Inline Color Label\nDescription: Filtro inline de cor/label com grid de cores, seleção visual e badges removíveis.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, color, label, filter, inline, multiselect\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-color-label/inline-color-label.metadata.ts", "contentHash": "d174b1f760eb5a9b01f3583141983240b66139355a8feeb0f33c4bd01d053057", "sourceKind": "component_definition", "sourceId": "pdx-inline-color-label", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-inline-color-label", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-color-label | controlType: inlineColorLabel | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-color-label\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"color-label\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por etiquetas coloridas quando o texto da opcao continua sendo o principal canal de leitura\",\n \"avoidWhen\": \"a cor sozinha carrega o significado ou o estado precisa continuar claro em acessibilidade sem apoio textual\",\n \"examplePrompts\": [\n \"crie um filtro inline de etiquetas por cor\",\n \"adicione inlineColorLabel para squads com badge textual\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"labels\",\n \"label\": \"Etiquetas\",\n \"placeholder\": \"Selecionar etiquetas\",\n \"controlType\": \"inlineColorLabel\",\n \"multiple\": true,\n \"colorLabelOptions\": [\n { \"id\": \"red\", \"label\": \"Critico\", \"value\": \"critical\", \"color\": \"#ef4444\" },\n { \"id\": \"yellow\", \"label\": \"Atencao\", \"value\": \"warning\", \"color\": \"#eab308\" },\n { \"id\": \"green\", \"label\": \"Estavel\", \"value\": \"stable\", \"color\": \"#22c55e\" }\n ],\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true\n },\n \"ariaLabel\": \"Filtro por etiquetas coloridas\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-color-label.json", "contentHash": "b0dc477312c86ec68fadf13b52cc5b38cf3821ff9d8e0bad2491792b9efff7ce", "sourceKind": "component_definition", "sourceId": "pdx-inline-color-label", "corpusVersion": "1.0.0" } ] }, "pdx-inline-currency": { "id": "pdx-inline-currency", "description": "Campo monetário compacto para filtros sempre visíveis na barra dinâmica.", "inputs": [ { "name": "metadata", "type": "MaterialCurrencyMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-currency", "friendlyName": "Inline Currency", "icon": "payments", "tags": [ "widget", "field", "currency", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-currency/inline-currency.metadata.ts", "exportName": "PDX_INLINE_CURRENCY_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-currency\nSelector: pdx-inline-currency\nFriendly Name: Inline Currency\nDescription: Campo monetário compacto para filtros sempre visíveis na barra dinâmica.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, currency, filter, inline\nInputs:\n - metadata (MaterialCurrencyMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-currency/inline-currency.metadata.ts", "contentHash": "1f5ac456d61b1044717ce1671f7c09384580954d60fdcdf2c620124403f62aff", "sourceKind": "component_definition", "sourceId": "pdx-inline-currency", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"currency\",\n \"title\": \"Currency controls\",\n \"description\": \"Profile for currency and price-range controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-currency\",\n \"pdx-inline-currency-range\",\n \"pdx-material-currency\",\n \"pdx-material-price-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Currency metadata paths such as currency code, locale, precision and range mode.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.currency.configure\",\n \"title\": \"Configure currency field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"currencyCode\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"rangeMode\": {\n \"enum\": [\n \"single\",\n \"range\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"currency-code-valid\",\n \"currency-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.currencyCode\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.rangeMode\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"currency-code-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP003\",\n \"description\": \"Currency controls require a valid ISO currency code and locale-aware formatting semantics.\"\n },\n {\n \"validatorId\": \"currency-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP004\",\n \"description\": \"Currency range bounds must be ordered and compatible with precision.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-brl-currency\",\n \"request\": \"Configure the currency field for Brazilian Real with two decimals.\",\n \"operationId\": \"field.currency.configure\",\n \"params\": {\n \"currencyCode\": \"BRL\",\n \"locale\": \"pt-BR\",\n \"precision\": 2\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "77f0d05de3620497f1f0270555d45b1d54528f61e2a935815156163846b9acfb", "sourceKind": "component_definition", "sourceId": "pdx-inline-currency", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-currency | controlType: inlineCurrency | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-currency\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"currency\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por valor monetario unico\",\n \"examplePrompts\": [\n \"crie um filtro inline de valor minimo\",\n \"adicione inlineCurrency para preco alvo\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"minValue\",\n \"label\": \"Valor minimo\",\n \"placeholder\": \"R$ 0,00\",\n \"controlType\": \"inlineCurrency\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de valor minimo\"\n },\n \"currency\": \"BRL\",\n \"locale\": \"pt-BR\",\n \"decimalPlaces\": 2,\n \"allowNegative\": false,\n \"min\": 0,\n \"ariaLabel\": \"Filtro de valor monetario minimo\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-currency.json", "contentHash": "22f38ed3d572a6464831dae5aac9fc692e1d4576dcac523cfdc2b85183bf50a9", "sourceKind": "component_definition", "sourceId": "pdx-inline-currency", "corpusVersion": "1.0.0" } ] }, "pdx-inline-currency-range": { "id": "pdx-inline-currency-range", "description": "Faixa monetária compacta para filtros sempre visíveis na barra dinâmica, com histograma decorativo inline, agregação automática (até 48 barras renderizadas), espaçamento adaptativo para painéis estreitos e painel em popover não-modal.", "inputs": [ { "name": "metadata", "type": "MaterialPriceRangeMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-currency-range", "friendlyName": "Inline Currency Range", "icon": "attach_money", "tags": [ "widget", "field", "currency", "range", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-currency-range/inline-currency-range.metadata.ts", "exportName": "PDX_INLINE_CURRENCY_RANGE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-currency-range\nSelector: pdx-inline-currency-range\nFriendly Name: Inline Currency Range\nDescription: Faixa monetária compacta para filtros sempre visíveis na barra dinâmica, com histograma decorativo inline, agregação automática (até 48 barras renderizadas), espaçamento adaptativo para painéis estreitos e painel em popover não-modal.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, currency, range, filter, inline\nInputs:\n - metadata (MaterialPriceRangeMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-currency-range/inline-currency-range.metadata.ts", "contentHash": "311f873623482b0f78e3bfced46ea32b503e2fc3a0625c805ade4eb15b02db45", "sourceKind": "component_definition", "sourceId": "pdx-inline-currency-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"currency\",\n \"title\": \"Currency controls\",\n \"description\": \"Profile for currency and price-range controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-currency\",\n \"pdx-inline-currency-range\",\n \"pdx-material-currency\",\n \"pdx-material-price-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Currency metadata paths such as currency code, locale, precision and range mode.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.currency.configure\",\n \"title\": \"Configure currency field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"currencyCode\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"rangeMode\": {\n \"enum\": [\n \"single\",\n \"range\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"currency-code-valid\",\n \"currency-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.currencyCode\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.rangeMode\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"currency-code-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP003\",\n \"description\": \"Currency controls require a valid ISO currency code and locale-aware formatting semantics.\"\n },\n {\n \"validatorId\": \"currency-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP004\",\n \"description\": \"Currency range bounds must be ordered and compatible with precision.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-brl-currency\",\n \"request\": \"Configure the currency field for Brazilian Real with two decimals.\",\n \"operationId\": \"field.currency.configure\",\n \"params\": {\n \"currencyCode\": \"BRL\",\n \"locale\": \"pt-BR\",\n \"precision\": 2\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "77f0d05de3620497f1f0270555d45b1d54528f61e2a935815156163846b9acfb", "sourceKind": "component_definition", "sourceId": "pdx-inline-currency-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-currency-range | controlType: inlineCurrencyRange | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-currency-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"currency\",\n \"range\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por faixa monetaria em processos comerciais\",\n \"examplePrompts\": [\n \"crie um filtro inline de faixa de preco\",\n \"adicione inlineCurrencyRange para orçamento\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"budgetRange\",\n \"label\": \"Faixa de valor\",\n \"placeholder\": \"R$ 1.000 ate R$ 8.000\",\n \"controlType\": \"inlineCurrencyRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de faixa de valor\"\n },\n \"currency\": \"BRL\",\n \"locale\": \"pt-BR\",\n \"decimalPlaces\": 2,\n \"allowNegative\": false,\n \"min\": 0,\n \"max\": 100000,\n \"step\": 100,\n \"startLabel\": \"De\",\n \"endLabel\": \"Ate\",\n \"startPlaceholder\": \"Minimo\",\n \"endPlaceholder\": \"Maximo\",\n \"rangeSeparator\": \"ate\",\n \"defaultValue\": {\n \"start\": 1000,\n \"end\": 8000\n },\n \"ariaLabel\": \"Filtro de faixa monetaria\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-currency-range.json", "contentHash": "cf561139937107aee730667c44ad6c1fccacb7673e472efc606c334f3df9f844", "sourceKind": "component_definition", "sourceId": "pdx-inline-currency-range", "corpusVersion": "1.0.0" } ] }, "pdx-inline-date": { "id": "pdx-inline-date", "description": "Datepicker compacto para barras de filtro dinâmico, com foco em economia horizontal.", "inputs": [ { "name": "metadata", "type": "MaterialDatepickerMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-date", "friendlyName": "Inline Date", "icon": "event", "tags": [ "widget", "field", "date", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-date/inline-date.metadata.ts", "exportName": "PDX_INLINE_DATE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-date\nSelector: pdx-inline-date\nFriendly Name: Inline Date\nDescription: Datepicker compacto para barras de filtro dinâmico, com foco em economia horizontal.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, date, filter, inline\nInputs:\n - metadata (MaterialDatepickerMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-date/inline-date.metadata.ts", "contentHash": "42ef443f1b2b0a444b6bf7f4c8ac7a9979917a4c5bcf859be215c4cbddd87ae6", "sourceKind": "component_definition", "sourceId": "pdx-inline-date", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date\",\n \"title\": \"Date controls\",\n \"description\": \"Profile for single date, datetime, month, week, year and time picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-date-input\",\n \"pdx-datetime-local-input\",\n \"pdx-inline-date\",\n \"pdx-inline-time\",\n \"pdx-material-datepicker\",\n \"pdx-material-timepicker\",\n \"pdx-month-input\",\n \"pdx-time-input\",\n \"pdx-week-input\",\n \"pdx-year-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date/time metadata paths such as min, max, timezone, locale and format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.date.configure\",\n \"title\": \"Configure date or time field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"timezone\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"temporal-bounds-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.timezone\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.format\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-min-max\",\n \"request\": \"Limit the date field to the current year in Sao Paulo timezone.\",\n \"operationId\": \"field.date.configure\",\n \"params\": {\n \"min\": \"2026-01-01\",\n \"max\": \"2026-12-31\",\n \"timezone\": \"America/Sao_Paulo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "08eab5ad75f996b139ebddd730883a5cd6895567e2c3a16cafc4ddf60e53b185", "sourceKind": "component_definition", "sourceId": "pdx-inline-date", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-date | controlType: inlineDate | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-date\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"date\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por data exata de evento\",\n \"examplePrompts\": [\n \"crie um filtro inline de data de abertura\",\n \"adicione inlineDate para vencimento\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"dueDate\",\n \"label\": \"Data limite\",\n \"placeholder\": \"dd/mm/aaaa\",\n \"controlType\": \"inlineDate\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de data limite\"\n },\n \"minDate\": \"2024-01-01\",\n \"maxDate\": \"2026-12-31\",\n \"startView\": \"month\",\n \"datepickerTogglePosition\": \"suffix\",\n \"ariaLabel\": \"Filtro de data limite\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-date.json", "contentHash": "7df289c0468a83f740b907ecde67375be2564038e4e9d1134ea256d639dda965", "sourceKind": "component_definition", "sourceId": "pdx-inline-date", "corpusVersion": "1.0.0" } ] }, "pdx-inline-date-range": { "id": "pdx-inline-date-range", "description": "Intervalo de datas compacto para barras de filtro dinâmico, com autosize e presets rápidos no overlay do calendário.", "inputs": [ { "name": "metadata", "type": "MaterialDateRangeMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-date-range", "friendlyName": "Inline Date Range", "icon": "date_range", "tags": [ "widget", "field", "date", "date-range", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-date-range/inline-date-range.metadata.ts", "exportName": "PDX_INLINE_DATE_RANGE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-date-range\nSelector: pdx-inline-date-range\nFriendly Name: Inline Date Range\nDescription: Intervalo de datas compacto para barras de filtro dinâmico, com autosize e presets rápidos no overlay do calendário.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, date, date-range, filter, inline\nInputs:\n - metadata (MaterialDateRangeMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-date-range/inline-date-range.metadata.ts", "contentHash": "b67f622765f7c18b5fac6c97ad21b68e5d8b44427e4cfb9a966075bc94d8504e", "sourceKind": "component_definition", "sourceId": "pdx-inline-date-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date-range\",\n \"title\": \"Date range controls\",\n \"description\": \"Profile for date range, month range, year range, period and relative-period controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-date-range\",\n \"pdx-inline-month-range\",\n \"pdx-inline-period-range\",\n \"pdx-inline-relative-period\",\n \"pdx-inline-year-range\",\n \"pdx-material-date-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date range metadata paths such as start/end field mapping, min/max and presets.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.dateRange.configure\",\n \"title\": \"Configure date range field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"startField\": {\n \"type\": \"string\"\n },\n \"endField\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"presets\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"date-range-fields-valid\",\n \"temporal-bounds-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.startField\",\n \"fieldMetadata.endField\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.presets\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"date-range-fields-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP013\",\n \"description\": \"Date range controls require distinct start/end field semantics and ordered submitted values.\"\n },\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-range-fields\",\n \"request\": \"Use createdFrom and createdTo as the date range field names.\",\n \"operationId\": \"field.dateRange.configure\",\n \"params\": {\n \"startField\": \"createdFrom\",\n \"endField\": \"createdTo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "341f9bca8da5ec291232bdda90ba13821bb60134fc7892d9e14078948696da03", "sourceKind": "component_definition", "sourceId": "pdx-inline-date-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-date-range | controlType: inlineDateRange | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-date-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"date-range\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por intervalo de datas em auditoria e relatorios\",\n \"examplePrompts\": [\n \"crie um filtro inline de periodo\",\n \"adicione inlineDateRange para intervalo de criação\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"createdAtRange\",\n \"label\": \"Periodo\",\n \"placeholder\": \"Inicio e fim\",\n \"controlType\": \"inlineDateRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de periodo\"\n },\n \"minDate\": \"2024-01-01\",\n \"maxDate\": \"2026-12-31\",\n \"startPlaceholder\": \"Inicio\",\n \"endPlaceholder\": \"Fim\",\n \"rangeSeparator\": \"ate\",\n \"ariaLabel\": \"Filtro por periodo de datas\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-date-range.json", "contentHash": "0961c11fbfe21d94a42ba0dcf110c88bd884ccd29eeb4fe0f5a9d3ce9e0ea82c", "sourceKind": "component_definition", "sourceId": "pdx-inline-date-range", "corpusVersion": "1.0.0" } ] }, "pdx-inline-distance-radius": { "id": "pdx-inline-distance-radius", "description": "Filtro inline de raio de distância com visual radial, slider single/range, toggle de unidade (km/mi) e presets.", "inputs": [ { "name": "metadata", "type": "MaterialRangeSliderMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-distance-radius", "friendlyName": "Inline Distance Radius", "icon": "place", "tags": [ "widget", "field", "distance", "radius", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-distance-radius/inline-distance-radius.metadata.ts", "exportName": "PDX_INLINE_DISTANCE_RADIUS_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-distance-radius\nSelector: pdx-inline-distance-radius\nFriendly Name: Inline Distance Radius\nDescription: Filtro inline de raio de distância com visual radial, slider single/range, toggle de unidade (km/mi) e presets.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, distance, radius, filter, inline\nInputs:\n - metadata (MaterialRangeSliderMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-distance-radius/inline-distance-radius.metadata.ts", "contentHash": "4b4efb3cb353d092915a0634d3ad0278da6fde3d21fd7ee7773e8fe826c41cb8", "sourceKind": "component_definition", "sourceId": "pdx-inline-distance-radius", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"numeric\",\n \"title\": \"Numeric controls\",\n \"description\": \"Profile for number, slider, range, rating, distance and score controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-distance-radius\",\n \"pdx-inline-number\",\n \"pdx-inline-range-slider\",\n \"pdx-inline-rating\",\n \"pdx-inline-score-priority\",\n \"pdx-material-range-slider\",\n \"pdx-material-rating\",\n \"pdx-material-slider\",\n \"pdx-number-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Numeric metadata paths such as min, max, step, precision and display format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.numeric.configure\",\n \"title\": \"Configure numeric field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"step\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"displayFormat\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"numeric-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.step\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.displayFormat\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"numeric-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP002\",\n \"description\": \"Numeric min, max, step and precision must be mutually valid for the target control.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-rating-scale\",\n \"request\": \"Set rating control to five points with half-step increments.\",\n \"operationId\": \"field.numeric.configure\",\n \"params\": {\n \"min\": 0,\n \"max\": 5,\n \"step\": 0.5\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "356c72bdee9ea6470f4037c40e9e605bf4557caa37fc1f16b9dc0a8fa63880e6", "sourceKind": "component_definition", "sourceId": "pdx-inline-distance-radius", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-distance-radius | controlType: inlineDistanceRadius | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-distance-radius\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"distance\",\n \"radius\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por raio de distancia com alternancia de unidade km/mi\",\n \"examplePrompts\": [\n \"crie um filtro inline de raio de distancia\",\n \"adicione inlineDistanceRadius para busca geoespacial\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"distanceRadius\",\n \"label\": \"Raio de distancia\",\n \"placeholder\": \"Selecione o raio\",\n \"controlType\": \"inlineDistanceRadius\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"mode\": \"range\",\n \"min\": 1,\n \"max\": 150,\n \"step\": 1,\n \"distanceUnit\": \"km\",\n \"distanceBaseUnit\": \"km\",\n \"distanceAllowUnitToggle\": true,\n \"distanceSubtitle\": \"Visualizacao radial com controle de raio e unidade\",\n \"distancePresets\": [5, 10, 25, 50, 100],\n \"distanceRadialRings\": 5,\n \"distanceAccentColor\": \"#3f5be6\",\n \"inlineAutoSize\": {\n \"minWidth\": 188,\n \"maxWidth\": 360,\n \"panelMinWidth\": 340,\n \"panelMaxWidth\": 560\n },\n \"ariaLabel\": \"Filtro de raio de distancia\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-distance-radius.json", "contentHash": "00f2655d72b44f7ecdae2d35ac63a5bd6b0be58b68be7a141ed055d95df6f795", "sourceKind": "component_definition", "sourceId": "pdx-inline-distance-radius", "corpusVersion": "1.0.0" } ] }, "pdx-inline-input": { "id": "pdx-inline-input", "description": "Input de texto compacto para uso em barras de filtro dinâmico.", "inputs": [ { "name": "metadata", "type": "MaterialInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-input", "friendlyName": "Inline Input", "icon": "search", "tags": [ "widget", "field", "input", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-input/inline-input.metadata.ts", "exportName": "PDX_INLINE_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-input\nSelector: pdx-inline-input\nFriendly Name: Inline Input\nDescription: Input de texto compacto para uso em barras de filtro dinâmico.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, filter, inline\nInputs:\n - metadata (MaterialInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-input/inline-input.metadata.ts", "contentHash": "cf01962c9e1ff904da9023f3f8e899ed0f31bf64b529eb79210bb5e3bd1868b1", "sourceKind": "component_definition", "sourceId": "pdx-inline-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"text-input\",\n \"title\": \"Text input controls\",\n \"description\": \"Profile for text-like controls, including inline and Material text inputs.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-email-input\",\n \"pdx-inline-input\",\n \"pdx-inline-phone\",\n \"pdx-material-textarea\",\n \"pdx-password-input\",\n \"pdx-phone-input\",\n \"pdx-search-input\",\n \"pdx-text-input\",\n \"pdx-url-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.text.configure\",\n \"title\": \"Configure text field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"placeholder\": {\n \"type\": \"string\"\n },\n \"minLength\": {\n \"type\": \"number\"\n },\n \"maxLength\": {\n \"type\": \"number\"\n },\n \"pattern\": {\n \"type\": \"string\"\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"autocomplete\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"text-metadata-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.placeholder\",\n \"fieldMetadata.minLength\",\n \"fieldMetadata.maxLength\",\n \"fieldMetadata.pattern\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.autocomplete\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"text-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP001\",\n \"description\": \"Text constraints must preserve string field semantics and editor/runtime round-trip.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-text-placeholder-and-length\",\n \"request\": \"Set placeholder and maximum length for a text input.\",\n \"operationId\": \"field.text.configure\",\n \"params\": {\n \"placeholder\": \"Search by name\",\n \"maxLength\": 120\n },\n \"isPositive\": true\n }\n ],\n \"roundTripRequirements\": [\n \"Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state.\"\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "c0029e40a022738aabac65b76da38df2467c0f2c2e2e743baebc4841554e762b", "sourceKind": "component_definition", "sourceId": "pdx-inline-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-input | controlType: inlineInput | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"text\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por texto livre com aplicacao recorrente em listas\",\n \"examplePrompts\": [\n \"crie um filtro inline de texto para buscar cliente\",\n \"adicione inlineInput para pesquisa rapida\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"searchTerm\",\n \"label\": \"Buscar\",\n \"placeholder\": \"Cliente, ticket ou protocolo\",\n \"controlType\": \"inlineInput\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de buscar\"\n },\n \"hint\": \"Aceita trechos do nome, codigo ou documento\",\n \"debounceTime\": 250,\n \"minLength\": 2,\n \"maxLength\": 120,\n \"ariaLabel\": \"Filtro de busca textual\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-input.json", "contentHash": "3268c9963e72d11766a2a8bab5e8adc934696812d3754754a7344f99ca27fccc", "sourceKind": "component_definition", "sourceId": "pdx-inline-input", "corpusVersion": "1.0.0" } ] }, "pdx-inline-month-range": { "id": "pdx-inline-month-range", "description": "Faixa mensal compacta para filtros inline, com leitura por nomes de mês e atalhos de trimestre/semestre para dashboards analíticos.", "inputs": [ { "name": "metadata", "type": "InlineMonthRangeMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-month-range", "friendlyName": "Inline Month Range", "icon": "calendar_view_month", "tags": [ "widget", "field", "month", "range", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-month-range/inline-month-range.metadata.ts", "exportName": "PDX_INLINE_MONTH_RANGE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-month-range\nSelector: pdx-inline-month-range\nFriendly Name: Inline Month Range\nDescription: Faixa mensal compacta para filtros inline, com leitura por nomes de mês e atalhos de trimestre/semestre para dashboards analíticos.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, month, range, filter, inline\nInputs:\n - metadata (InlineMonthRangeMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-month-range/inline-month-range.metadata.ts", "contentHash": "cb120626a76579232ef8942a6b90d94e973e399849e4b417d539d01ad5d6b6de", "sourceKind": "component_definition", "sourceId": "pdx-inline-month-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date-range\",\n \"title\": \"Date range controls\",\n \"description\": \"Profile for date range, month range, year range, period and relative-period controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-date-range\",\n \"pdx-inline-month-range\",\n \"pdx-inline-period-range\",\n \"pdx-inline-relative-period\",\n \"pdx-inline-year-range\",\n \"pdx-material-date-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date range metadata paths such as start/end field mapping, min/max and presets.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.dateRange.configure\",\n \"title\": \"Configure date range field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"startField\": {\n \"type\": \"string\"\n },\n \"endField\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"presets\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"date-range-fields-valid\",\n \"temporal-bounds-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.startField\",\n \"fieldMetadata.endField\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.presets\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"date-range-fields-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP013\",\n \"description\": \"Date range controls require distinct start/end field semantics and ordered submitted values.\"\n },\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-range-fields\",\n \"request\": \"Use createdFrom and createdTo as the date range field names.\",\n \"operationId\": \"field.dateRange.configure\",\n \"params\": {\n \"startField\": \"createdFrom\",\n \"endField\": \"createdTo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "341f9bca8da5ec291232bdda90ba13821bb60134fc7892d9e14078948696da03", "sourceKind": "component_definition", "sourceId": "pdx-inline-month-range", "corpusVersion": "1.0.0" } ] }, "pdx-inline-multi-select": { "id": "pdx-inline-multi-select", "description": "Multi select compacto para filtros dinâmicos em formato badge/pill.", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-multi-select", "friendlyName": "Inline Multi Select", "icon": "checklist", "tags": [ "widget", "field", "multi-select", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-multi-select/inline-multi-select.metadata.ts", "exportName": "PDX_INLINE_MULTI_SELECT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-multi-select\nSelector: pdx-inline-multi-select\nFriendly Name: Inline Multi Select\nDescription: Multi select compacto para filtros dinâmicos em formato badge/pill.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, multi-select, filter, inline\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-multi-select/inline-multi-select.metadata.ts", "contentHash": "86b43a14fe2835af4c28ba20cb6ea78ab5c0ff56028b566174c58a7ccf7209d1", "sourceKind": "component_definition", "sourceId": "pdx-inline-multi-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-inline-multi-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-multi-select | controlType: inlineMultiSelect | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-multi-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"multi-select\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por multiplos valores no mesmo criterio\",\n \"examplePrompts\": [\n \"crie um filtro inline multi-select de canal\",\n \"adicione inlineMultiSelect para tags\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"channels\",\n \"label\": \"Canais\",\n \"placeholder\": \"Selecionar canais\",\n \"controlType\": \"inlineMultiSelect\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de canais\"\n },\n \"multiple\": true,\n \"searchable\": true,\n \"selectAll\": true,\n \"options\": [\n {\n \"key\": \"Web\",\n \"value\": \"web\"\n },\n {\n \"key\": \"Mobile\",\n \"value\": \"mobile\"\n },\n {\n \"key\": \"Loja fisica\",\n \"value\": \"store\"\n },\n {\n \"key\": \"Parceiros\",\n \"value\": \"partners\"\n }\n ],\n \"emptyOptionText\": \"Todos os canais\",\n \"ariaLabel\": \"Filtro multi-select de canais\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-multi-select.json", "contentHash": "43d2a8cfde9af2d289066c11c1137f0bdc25a8012f0f447dc89a57c440aaecdf", "sourceKind": "component_definition", "sourceId": "pdx-inline-multi-select", "corpusVersion": "1.0.0" } ] }, "pdx-inline-number": { "id": "pdx-inline-number", "description": "Campo numérico compacto para filtros sempre visíveis na barra dinâmica, com suporte a modo percentual (sufixo `%`).", "inputs": [ { "name": "metadata", "type": "MaterialNumericMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-number", "friendlyName": "Inline Number", "icon": "tag", "tags": [ "widget", "field", "number", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-number/inline-number.metadata.ts", "exportName": "PDX_INLINE_NUMBER_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-number\nSelector: pdx-inline-number\nFriendly Name: Inline Number\nDescription: Campo numérico compacto para filtros sempre visíveis na barra dinâmica, com suporte a modo percentual (sufixo `%`).\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, number, filter, inline\nInputs:\n - metadata (MaterialNumericMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-number/inline-number.metadata.ts", "contentHash": "4cded654dc30f05791c5ec28535c6af61dd50e7b84cb366916ba46cb5d2b9ced", "sourceKind": "component_definition", "sourceId": "pdx-inline-number", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"numeric\",\n \"title\": \"Numeric controls\",\n \"description\": \"Profile for number, slider, range, rating, distance and score controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-distance-radius\",\n \"pdx-inline-number\",\n \"pdx-inline-range-slider\",\n \"pdx-inline-rating\",\n \"pdx-inline-score-priority\",\n \"pdx-material-range-slider\",\n \"pdx-material-rating\",\n \"pdx-material-slider\",\n \"pdx-number-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Numeric metadata paths such as min, max, step, precision and display format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.numeric.configure\",\n \"title\": \"Configure numeric field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"step\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"displayFormat\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"numeric-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.step\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.displayFormat\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"numeric-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP002\",\n \"description\": \"Numeric min, max, step and precision must be mutually valid for the target control.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-rating-scale\",\n \"request\": \"Set rating control to five points with half-step increments.\",\n \"operationId\": \"field.numeric.configure\",\n \"params\": {\n \"min\": 0,\n \"max\": 5,\n \"step\": 0.5\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "356c72bdee9ea6470f4037c40e9e605bf4557caa37fc1f16b9dc0a8fa63880e6", "sourceKind": "component_definition", "sourceId": "pdx-inline-number", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-number | controlType: inlineNumber | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-number\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"number\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por valores numericos com faixas simples\",\n \"examplePrompts\": [\n \"crie um inlineNumber para score minimo\",\n \"adicione filtro numerico inline para prioridade\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"priorityScore\",\n \"label\": \"Score minimo\",\n \"placeholder\": \"0\",\n \"controlType\": \"inlineNumber\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de score minimo\"\n },\n \"min\": 0,\n \"max\": 100,\n \"step\": 1,\n \"inputMode\": \"numeric\",\n \"ariaLabel\": \"Filtro numerico de score\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-number.json", "contentHash": "3ea645f345c25cc7a005ba2ccd02ea9b50d71cc2fd92450f238e87314e8c6c9a", "sourceKind": "component_definition", "sourceId": "pdx-inline-number", "corpusVersion": "1.0.0" } ] }, "pdx-inline-period-range": { "id": "pdx-inline-period-range", "description": "Faixa temporal corporativa por granularidade, cobrindo meses, trimestres, anos e períodos fiscais em um contrato inline canônico.", "inputs": [ { "name": "metadata", "type": "InlinePeriodRangeMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-period-range", "friendlyName": "Inline Period Range", "icon": "date_range", "tags": [ "widget", "field", "period", "range", "filter", "inline", "temporal" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-period-range/inline-period-range.metadata.ts", "exportName": "PDX_INLINE_PERIOD_RANGE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-period-range\nSelector: pdx-inline-period-range\nFriendly Name: Inline Period Range\nDescription: Faixa temporal corporativa por granularidade, cobrindo meses, trimestres, anos e períodos fiscais em um contrato inline canônico.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, period, range, filter, inline, temporal\nInputs:\n - metadata (InlinePeriodRangeMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-period-range/inline-period-range.metadata.ts", "contentHash": "5491da8ac0c08e7dd1dc83806d30e722938b5eb0dfebf7b58bd972907bd73671", "sourceKind": "component_definition", "sourceId": "pdx-inline-period-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date-range\",\n \"title\": \"Date range controls\",\n \"description\": \"Profile for date range, month range, year range, period and relative-period controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-date-range\",\n \"pdx-inline-month-range\",\n \"pdx-inline-period-range\",\n \"pdx-inline-relative-period\",\n \"pdx-inline-year-range\",\n \"pdx-material-date-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date range metadata paths such as start/end field mapping, min/max and presets.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.dateRange.configure\",\n \"title\": \"Configure date range field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"startField\": {\n \"type\": \"string\"\n },\n \"endField\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"presets\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"date-range-fields-valid\",\n \"temporal-bounds-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.startField\",\n \"fieldMetadata.endField\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.presets\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"date-range-fields-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP013\",\n \"description\": \"Date range controls require distinct start/end field semantics and ordered submitted values.\"\n },\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-range-fields\",\n \"request\": \"Use createdFrom and createdTo as the date range field names.\",\n \"operationId\": \"field.dateRange.configure\",\n \"params\": {\n \"startField\": \"createdFrom\",\n \"endField\": \"createdTo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "341f9bca8da5ec291232bdda90ba13821bb60134fc7892d9e14078948696da03", "sourceKind": "component_definition", "sourceId": "pdx-inline-period-range", "corpusVersion": "1.0.0" } ] }, "pdx-inline-phone": { "id": "pdx-inline-phone", "description": "praxis.dynamicFields.editorial.inlinePhone.description", "inputs": [ { "name": "metadata", "type": "MaterialInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-inline-phone", "friendlyName": "praxis.dynamicFields.editorial.inlinePhone.friendlyName", "icon": "phone", "tags": [ "widget", "field", "input", "phone", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-input/inline-input.metadata.ts", "exportName": "PDX_INLINE_PHONE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-phone\nSelector: pdx-inline-phone\nFriendly Name: praxis.dynamicFields.editorial.inlinePhone.friendlyName\nDescription: praxis.dynamicFields.editorial.inlinePhone.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, phone, filter, inline\nInputs:\n - metadata (MaterialInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-input/inline-input.metadata.ts", "contentHash": "ffd342757af004bcc1212504f8d42c83246726498ead9fbe603e22ee834ec7c8", "sourceKind": "component_definition", "sourceId": "pdx-inline-phone", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"text-input\",\n \"title\": \"Text input controls\",\n \"description\": \"Profile for text-like controls, including inline and Material text inputs.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-email-input\",\n \"pdx-inline-input\",\n \"pdx-inline-phone\",\n \"pdx-material-textarea\",\n \"pdx-password-input\",\n \"pdx-phone-input\",\n \"pdx-search-input\",\n \"pdx-text-input\",\n \"pdx-url-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.text.configure\",\n \"title\": \"Configure text field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"placeholder\": {\n \"type\": \"string\"\n },\n \"minLength\": {\n \"type\": \"number\"\n },\n \"maxLength\": {\n \"type\": \"number\"\n },\n \"pattern\": {\n \"type\": \"string\"\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"autocomplete\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"text-metadata-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.placeholder\",\n \"fieldMetadata.minLength\",\n \"fieldMetadata.maxLength\",\n \"fieldMetadata.pattern\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.autocomplete\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"text-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP001\",\n \"description\": \"Text constraints must preserve string field semantics and editor/runtime round-trip.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-text-placeholder-and-length\",\n \"request\": \"Set placeholder and maximum length for a text input.\",\n \"operationId\": \"field.text.configure\",\n \"params\": {\n \"placeholder\": \"Search by name\",\n \"maxLength\": 120\n },\n \"isPositive\": true\n }\n ],\n \"roundTripRequirements\": [\n \"Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state.\"\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "c0029e40a022738aabac65b76da38df2467c0f2c2e2e743baebc4841554e762b", "sourceKind": "component_definition", "sourceId": "pdx-inline-phone", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-phone | controlType: inlinePhone | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-phone\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"text\",\n \"phone\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar listas por telefone de contato preservando teclado tel e mascara visual\",\n \"examplePrompts\": [\n \"crie um filtro inline de telefone para contatos\",\n \"adicione inlinePhone para buscar por telefone\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"telefone\",\n \"label\": \"Telefone\",\n \"placeholder\": \"(11) 97100-0470\",\n \"controlType\": \"inlinePhone\",\n \"prefixIcon\": \"phone\",\n \"phoneFormat\": \"national\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de telefone\"\n },\n \"hint\": \"Preserva somente digitos no valor enviado pelo filtro\",\n \"debounceTime\": 250,\n \"minLength\": 8,\n \"maxLength\": 15,\n \"ariaLabel\": \"Filtro de telefone\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-phone.json", "contentHash": "15972ec318503b09b01013afa2e8bdb01922937594d000d53a35cf0758958ead", "sourceKind": "component_definition", "sourceId": "pdx-inline-phone", "corpusVersion": "1.0.0" } ] }, "pdx-inline-pipeline-status": { "id": "pdx-inline-pipeline-status", "description": "Filtro inline de status/etapas com popover, barra segmentada e seleção single ou múltipla totalmente configurável por metadados.", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-pipeline-status", "friendlyName": "Inline Pipeline Status", "icon": "timeline", "tags": [ "widget", "field", "pipeline", "status", "filter", "inline", "multiselect" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-pipeline-status/inline-pipeline-status.metadata.ts", "exportName": "PDX_INLINE_PIPELINE_STATUS_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-pipeline-status\nSelector: pdx-inline-pipeline-status\nFriendly Name: Inline Pipeline Status\nDescription: Filtro inline de status/etapas com popover, barra segmentada e seleção single ou múltipla totalmente configurável por metadados.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, pipeline, status, filter, inline, multiselect\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-pipeline-status/inline-pipeline-status.metadata.ts", "contentHash": "e20aabcf0276b326d4d5a09bb41ecc4748f018f847c7419bada2a37bbfac39a8", "sourceKind": "component_definition", "sourceId": "pdx-inline-pipeline-status", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-inline-pipeline-status", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-pipeline-status | controlType: inlinePipelineStatus | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-pipeline-status\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline\",\n \"pipeline\",\n \"status\",\n \"multiselect\"\n ],\n \"useWhen\": \"filtrar por estagios de funil ou status com selecao multipla e distribuicao visual\",\n \"avoidWhen\": \"o dominio usa enum simples de status sem jornada operacional real por etapas\",\n \"examplePrompts\": [\n \"crie um filtro inline de pipeline de status\",\n \"adicione inlinePipelineStatus para etapas comerciais\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"pipelineStatus\",\n \"label\": \"Pipeline de Status\",\n \"placeholder\": \"Selecione estagios\",\n \"controlType\": \"inlinePipelineStatus\",\n \"multiple\": true,\n \"pipelineSubtitle\": \"Funil visual de estagios com selecao multipla\",\n \"pipelineShowSelectionPills\": true,\n \"pipelineShowSelectAll\": true,\n \"pipelineSelectAllText\": \"Selecionar todos\",\n \"pipelineClearActionText\": \"Limpar filtro\",\n \"pipelineSearchable\": true,\n \"pipelineOptionSubtitleKey\": \"count\",\n \"pipelineOptionWeightKey\": \"weight\",\n \"pipelineOptionColorKey\": \"color\",\n \"pipelineOptions\": [\n { \"id\": \"draft\", \"label\": \"Rascunho\", \"value\": \"draft\", \"color\": \"#64748b\", \"count\": 12, \"weight\": 12 },\n { \"id\": \"sent\", \"label\": \"Enviado\", \"value\": \"sent\", \"color\": \"#0ea5e9\", \"count\": 28, \"weight\": 28 },\n { \"id\": \"analysis\", \"label\": \"Em analise\", \"value\": \"analysis\", \"color\": \"#f59e0b\", \"count\": 45, \"weight\": 45 },\n { \"id\": \"approved\", \"label\": \"Aprovado\", \"value\": \"approved\", \"color\": \"#22c55e\", \"count\": 32, \"weight\": 32 },\n { \"id\": \"rejected\", \"label\": \"Rejeitado\", \"value\": \"rejected\", \"color\": \"#ef4444\", \"count\": 8, \"weight\": 8 }\n ],\n \"pipelineTexts\": {\n \"selectionActionsAriaLabel\": \"Acoes de filtro do pipeline\",\n \"barAriaSelected\": \"{label} com {count} status selecionados\"\n },\n \"clearButton\": { \"enabled\": true, \"showOnlyWhenFilled\": true },\n \"ariaLabel\": \"Filtro de pipeline por status\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-pipeline-status.json", "contentHash": "e94c75a5ed66ce0a8e22a0d1386d77ce7a0242617f3ed07eff8a9710e25338f2", "sourceKind": "component_definition", "sourceId": "pdx-inline-pipeline-status", "corpusVersion": "1.0.0" } ] }, "pdx-inline-range-slider": { "id": "pdx-inline-range-slider", "description": "Range slider compacto para filtros numéricos na barra dinâmica, com suporte a formatação percentual (NumericFormat.PERCENT), histograma decorativo inline com agregação automática (até 48 barras renderizadas) e espaçamento adaptativo para painéis estreitos, além de painel em popover não-modal.", "inputs": [ { "name": "metadata", "type": "MaterialRangeSliderMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-range-slider", "friendlyName": "Inline Range Slider", "icon": "tune", "tags": [ "widget", "field", "range", "slider", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-range-slider/inline-range-slider.metadata.ts", "exportName": "PDX_INLINE_RANGE_SLIDER_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-range-slider\nSelector: pdx-inline-range-slider\nFriendly Name: Inline Range Slider\nDescription: Range slider compacto para filtros numéricos na barra dinâmica, com suporte a formatação percentual (NumericFormat.PERCENT), histograma decorativo inline com agregação automática (até 48 barras renderizadas) e espaçamento adaptativo para painéis estreitos, além de painel em popover não-modal.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, range, slider, filter, inline\nInputs:\n - metadata (MaterialRangeSliderMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-range-slider/inline-range-slider.metadata.ts", "contentHash": "3276e339ccaf62b9a2ba86a6287a9a9aa76787b37175c9b06e0285c9f4a56c1d", "sourceKind": "component_definition", "sourceId": "pdx-inline-range-slider", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"numeric\",\n \"title\": \"Numeric controls\",\n \"description\": \"Profile for number, slider, range, rating, distance and score controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-distance-radius\",\n \"pdx-inline-number\",\n \"pdx-inline-range-slider\",\n \"pdx-inline-rating\",\n \"pdx-inline-score-priority\",\n \"pdx-material-range-slider\",\n \"pdx-material-rating\",\n \"pdx-material-slider\",\n \"pdx-number-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Numeric metadata paths such as min, max, step, precision and display format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.numeric.configure\",\n \"title\": \"Configure numeric field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"step\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"displayFormat\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"numeric-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.step\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.displayFormat\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"numeric-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP002\",\n \"description\": \"Numeric min, max, step and precision must be mutually valid for the target control.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-rating-scale\",\n \"request\": \"Set rating control to five points with half-step increments.\",\n \"operationId\": \"field.numeric.configure\",\n \"params\": {\n \"min\": 0,\n \"max\": 5,\n \"step\": 0.5\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "356c72bdee9ea6470f4037c40e9e605bf4557caa37fc1f16b9dc0a8fa63880e6", "sourceKind": "component_definition", "sourceId": "pdx-inline-range-slider", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-range-slider | controlType: inlineRange | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-range-slider\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"range-slider\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por intervalo numerico continuo em UX compacta\",\n \"examplePrompts\": [\n \"crie um filtro inline de faixa percentual\",\n \"adicione inlineRange para score de risco\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"riskRange\",\n \"label\": \"Risco (%)\",\n \"placeholder\": \"0 a 100\",\n \"controlType\": \"inlineRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"min\": 0,\n \"max\": 100,\n \"step\": 5,\n \"thumbLabel\": true,\n \"showTicks\": true,\n \"defaultValue\": {\n \"start\": 20,\n \"end\": 80\n },\n \"ariaLabel\": \"Filtro de faixa percentual de risco\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-range-slider.json", "contentHash": "d893a6155cad8d3f8fde2e707cd894aa62f01a2566c67bbe1fdc633efd29497f", "sourceKind": "component_definition", "sourceId": "pdx-inline-range-slider", "corpusVersion": "1.0.0" } ] }, "pdx-inline-rating": { "id": "pdx-inline-rating", "description": "Faixa de rating compacta para barra de filtros, com popover, estrelas, slider de intervalo, meia estrela e cores configuráveis.", "inputs": [ { "name": "metadata", "type": "MaterialRangeSliderMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-rating", "friendlyName": "Inline Rating", "icon": "star", "tags": [ "widget", "field", "rating", "range", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-rating/inline-rating.metadata.ts", "exportName": "PDX_INLINE_RATING_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-rating\nSelector: pdx-inline-rating\nFriendly Name: Inline Rating\nDescription: Faixa de rating compacta para barra de filtros, com popover, estrelas, slider de intervalo, meia estrela e cores configuráveis.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, rating, range, filter, inline\nInputs:\n - metadata (MaterialRangeSliderMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-rating/inline-rating.metadata.ts", "contentHash": "4405b9b13251669b49f150ca885eee78afceb90c2cfc98c415c3262c733f25ab", "sourceKind": "component_definition", "sourceId": "pdx-inline-rating", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"numeric\",\n \"title\": \"Numeric controls\",\n \"description\": \"Profile for number, slider, range, rating, distance and score controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-distance-radius\",\n \"pdx-inline-number\",\n \"pdx-inline-range-slider\",\n \"pdx-inline-rating\",\n \"pdx-inline-score-priority\",\n \"pdx-material-range-slider\",\n \"pdx-material-rating\",\n \"pdx-material-slider\",\n \"pdx-number-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Numeric metadata paths such as min, max, step, precision and display format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.numeric.configure\",\n \"title\": \"Configure numeric field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"step\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"displayFormat\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"numeric-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.step\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.displayFormat\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"numeric-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP002\",\n \"description\": \"Numeric min, max, step and precision must be mutually valid for the target control.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-rating-scale\",\n \"request\": \"Set rating control to five points with half-step increments.\",\n \"operationId\": \"field.numeric.configure\",\n \"params\": {\n \"min\": 0,\n \"max\": 5,\n \"step\": 0.5\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "356c72bdee9ea6470f4037c40e9e605bf4557caa37fc1f16b9dc0a8fa63880e6", "sourceKind": "component_definition", "sourceId": "pdx-inline-rating", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-rating | controlType: inlineRating | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-rating\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"rating\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por faixa de avaliacao com estrelas em UX compacta\",\n \"examplePrompts\": [\n \"crie um filtro inline para faixa de rating\",\n \"adicione inlineRating para nota de satisfacao\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"ratingRange\",\n \"label\": \"Avaliacao\",\n \"placeholder\": \"1 a 5\",\n \"controlType\": \"inlineRating\",\n \"prefixIcon\": \"grade\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"min\": 1,\n \"max\": 5,\n \"allowHalf\": true,\n \"ratingToneLowColor\": \"#ef4444\",\n \"ratingToneMidColor\": \"#f59e0b\",\n \"ratingToneHighColor\": \"#22a45d\",\n \"ratingBadgeColor\": \"#f59e0b\",\n \"defaultValue\": {\n \"start\": 1,\n \"end\": 5\n },\n \"showInputs\": false,\n \"inlineAutoSize\": {\n \"minWidth\": 182,\n \"maxWidth\": 340,\n \"panelMinWidth\": 320,\n \"panelMaxWidth\": 520\n },\n \"ariaLabel\": \"Filtro de faixa de avaliacao\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-rating.json", "contentHash": "fbb0e4bb9504e70bcdbd743f083b509570ab21ecf18232be00782c325c7f4fe3", "sourceKind": "component_definition", "sourceId": "pdx-inline-rating", "corpusVersion": "1.0.0" } ] }, "pdx-inline-relative-period": { "id": "pdx-inline-relative-period", "description": "Filtro inline de período relativo com presets configuráveis, cards e barra de progresso visual.", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-relative-period", "friendlyName": "Inline Relative Period", "icon": "calendar_today", "tags": [ "widget", "field", "relative-period", "date", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-relative-period/inline-relative-period.metadata.ts", "exportName": "PDX_INLINE_RELATIVE_PERIOD_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-relative-period\nSelector: pdx-inline-relative-period\nFriendly Name: Inline Relative Period\nDescription: Filtro inline de período relativo com presets configuráveis, cards e barra de progresso visual.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, relative-period, date, filter, inline\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-relative-period/inline-relative-period.metadata.ts", "contentHash": "e496faa77f148159dd9f56d8dbb06a4b78ff0c401d542f3f87c269c8b462b4b3", "sourceKind": "component_definition", "sourceId": "pdx-inline-relative-period", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date-range\",\n \"title\": \"Date range controls\",\n \"description\": \"Profile for date range, month range, year range, period and relative-period controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-date-range\",\n \"pdx-inline-month-range\",\n \"pdx-inline-period-range\",\n \"pdx-inline-relative-period\",\n \"pdx-inline-year-range\",\n \"pdx-material-date-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date range metadata paths such as start/end field mapping, min/max and presets.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.dateRange.configure\",\n \"title\": \"Configure date range field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"startField\": {\n \"type\": \"string\"\n },\n \"endField\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"presets\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"date-range-fields-valid\",\n \"temporal-bounds-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.startField\",\n \"fieldMetadata.endField\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.presets\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"date-range-fields-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP013\",\n \"description\": \"Date range controls require distinct start/end field semantics and ordered submitted values.\"\n },\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-range-fields\",\n \"request\": \"Use createdFrom and createdTo as the date range field names.\",\n \"operationId\": \"field.dateRange.configure\",\n \"params\": {\n \"startField\": \"createdFrom\",\n \"endField\": \"createdTo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "341f9bca8da5ec291232bdda90ba13821bb60134fc7892d9e14078948696da03", "sourceKind": "component_definition", "sourceId": "pdx-inline-relative-period", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-relative-period | controlType: inlineRelativePeriod | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-relative-period\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"relative-period\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por atalhos temporais com normalizacao canonica do backend, como hoje, ultimos 7 dias e este mes\",\n \"avoidWhen\": \"a API nao normaliza presets relativos ou o time precisa rastrear datas finais explicitamente\",\n \"examplePrompts\": [\n \"crie um filtro inline de periodo relativo para dashboard analitico\",\n \"adicione inlineRelativePeriod para atalhos temporais canonicos\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"periodPreset\",\n \"label\": \"Periodo relativo\",\n \"placeholder\": \"Selecionar preset\",\n \"controlType\": \"inlineRelativePeriod\",\n \"relativePeriodShowProgress\": true,\n \"relativePeriodOptions\": [\n { \"id\": \"today\", \"label\": \"Hoje\", \"value\": \"today\", \"icon\": \"calendar_today\" },\n { \"id\": \"yesterday\", \"label\": \"Ontem\", \"value\": \"yesterday\", \"icon\": \"keyboard_double_arrow_left\" },\n { \"id\": \"last7\", \"label\": \"Ultimos 7 dias\", \"value\": \"last7\", \"icon\": \"date_range\" },\n { \"id\": \"last30\", \"label\": \"Ultimos 30 dias\", \"value\": \"last30\", \"icon\": \"event_repeat\" },\n { \"id\": \"thisMonth\", \"label\": \"Este mes\", \"value\": \"thisMonth\", \"icon\": \"event\" }\n ],\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de periodo relativo\"\n },\n \"ariaLabel\": \"Filtro de periodo relativo\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-relative-period.json", "contentHash": "7bc1477eae9182e2e3abb0dc88d1ce36497b15dba9cb310af19f821b309e7f96", "sourceKind": "component_definition", "sourceId": "pdx-inline-relative-period", "corpusVersion": "1.0.0" } ] }, "pdx-inline-score-priority": { "id": "pdx-inline-score-priority", "description": "Filtro inline de score/prioridade com faixa colorida, slider single/range, bandas configuráveis por metadados preservadas integralmente para semântica decisória, rótulos de escala com autoajuste de densidade e painel em popover não-modal.", "inputs": [ { "name": "metadata", "type": "MaterialRangeSliderMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-score-priority", "friendlyName": "Inline Score Priority", "icon": "speed", "tags": [ "widget", "field", "score", "priority", "range", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-score-priority/inline-score-priority.metadata.ts", "exportName": "PDX_INLINE_SCORE_PRIORITY_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-score-priority\nSelector: pdx-inline-score-priority\nFriendly Name: Inline Score Priority\nDescription: Filtro inline de score/prioridade com faixa colorida, slider single/range, bandas configuráveis por metadados preservadas integralmente para semântica decisória, rótulos de escala com autoajuste de densidade e painel em popover não-modal.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, score, priority, range, filter, inline\nInputs:\n - metadata (MaterialRangeSliderMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-score-priority/inline-score-priority.metadata.ts", "contentHash": "6ea93b5296323c9ec7ed43ecd050c836c1cb77a24bd0a94baf57f25e1f171385", "sourceKind": "component_definition", "sourceId": "pdx-inline-score-priority", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"numeric\",\n \"title\": \"Numeric controls\",\n \"description\": \"Profile for number, slider, range, rating, distance and score controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-distance-radius\",\n \"pdx-inline-number\",\n \"pdx-inline-range-slider\",\n \"pdx-inline-rating\",\n \"pdx-inline-score-priority\",\n \"pdx-material-range-slider\",\n \"pdx-material-rating\",\n \"pdx-material-slider\",\n \"pdx-number-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Numeric metadata paths such as min, max, step, precision and display format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.numeric.configure\",\n \"title\": \"Configure numeric field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"step\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"displayFormat\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"numeric-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.step\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.displayFormat\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"numeric-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP002\",\n \"description\": \"Numeric min, max, step and precision must be mutually valid for the target control.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-rating-scale\",\n \"request\": \"Set rating control to five points with half-step increments.\",\n \"operationId\": \"field.numeric.configure\",\n \"params\": {\n \"min\": 0,\n \"max\": 5,\n \"step\": 0.5\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "356c72bdee9ea6470f4037c40e9e605bf4557caa37fc1f16b9dc0a8fa63880e6", "sourceKind": "component_definition", "sourceId": "pdx-inline-score-priority", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-score-priority | controlType: inlineScorePriority | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-score-priority\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline\",\n \"score\",\n \"priority\",\n \"range\"\n ],\n \"useWhen\": \"filtrar por faixa de score severidade ou prioridade operacional\",\n \"examplePrompts\": [\n \"crie um filtro inline de score por severidade\",\n \"adicione inlineScorePriority com range de prioridade\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"priorityScore\",\n \"label\": \"Score / Prioridade\",\n \"placeholder\": \"Defina a faixa\",\n \"controlType\": \"inlineScorePriority\",\n \"mode\": \"range\",\n \"min\": 0,\n \"max\": 10,\n \"step\": 1,\n \"scoreBands\": [\n { \"id\": \"low\", \"label\": \"Baixo\", \"color\": \"#16a34a\", \"start\": 0, \"end\": 2.5 },\n { \"id\": \"medium\", \"label\": \"Medio\", \"color\": \"#f59e0b\", \"start\": 2.5, \"end\": 5 },\n { \"id\": \"high\", \"label\": \"Alto\", \"color\": \"#0ea5e9\", \"start\": 5, \"end\": 7.5 },\n { \"id\": \"critical\", \"label\": \"Critico\", \"color\": \"#ef4444\", \"start\": 7.5, \"end\": 10 }\n ],\n \"scoreShowBandChips\": true,\n \"scoreShowScaleLabels\": true,\n \"scoreRangeSeparator\": \"ate\",\n \"scoreBandsAriaLabel\": \"Faixas de severidade\",\n \"scoreBandAriaLabelTemplate\": \"{label}: de {start} ate {end}\",\n \"scoreValueFallbackColor\": \"#334155\",\n \"scorePalette\": [\"#16a34a\", \"#f59e0b\", \"#0ea5e9\", \"#ef4444\"],\n \"scoreTexts\": {\n \"panelSubtitle\": \"Escala configuravel para risco operacional\",\n \"bandsAriaLabel\": \"Faixas de risco\"\n },\n \"defaultValue\": { \"start\": 3, \"end\": 8 },\n \"clearButton\": { \"enabled\": true, \"showOnlyWhenFilled\": true },\n \"ariaLabel\": \"Filtro de score por prioridade\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-score-priority.json", "contentHash": "2b63960042c0eb31b9fd43d412881537584e2df29b6e1ee3860042488fcc8931", "sourceKind": "component_definition", "sourceId": "pdx-inline-score-priority", "corpusVersion": "1.0.0" } ] }, "pdx-inline-searchable-select": { "id": "pdx-inline-searchable-select", "description": "Select buscável compacto para barras de filtro, com comportamento de catálogo remoto/paginação.", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-searchable-select", "friendlyName": "Inline Searchable Select", "icon": "manage_search", "tags": [ "widget", "field", "searchable-select", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-searchable-select/inline-searchable-select.metadata.ts", "exportName": "PDX_INLINE_SEARCHABLE_SELECT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-searchable-select\nSelector: pdx-inline-searchable-select\nFriendly Name: Inline Searchable Select\nDescription: Select buscável compacto para barras de filtro, com comportamento de catálogo remoto/paginação.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, searchable-select, filter, inline\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-searchable-select/inline-searchable-select.metadata.ts", "contentHash": "728f7740662f2cd414ed816eb39aa4347bc98dfd31c8f752d020b895e467e537", "sourceKind": "component_definition", "sourceId": "pdx-inline-searchable-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-inline-searchable-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-searchable-select | controlType: inlineSearchableSelect | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-searchable-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"searchable-select\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por listas medias com busca local\",\n \"examplePrompts\": [\n \"crie um filtro inline buscavel de projeto\",\n \"adicione inlineSearchableSelect na toolbar\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"project\",\n \"label\": \"Projeto\",\n \"placeholder\": \"Buscar projeto\",\n \"controlType\": \"inlineSearchableSelect\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de projeto\"\n },\n \"searchable\": true,\n \"options\": [\n {\n \"key\": \"Portal Corporativo\",\n \"value\": \"portal\"\n },\n {\n \"key\": \"CRM Vendas\",\n \"value\": \"crm-sales\"\n },\n {\n \"key\": \"Ops Financeiro\",\n \"value\": \"ops-finance\"\n },\n {\n \"key\": \"Backoffice RH\",\n \"value\": \"rh-backoffice\"\n }\n ],\n \"emptyOptionText\": \"Todos os projetos\",\n \"ariaLabel\": \"Filtro buscavel de projeto\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-searchable-select.json", "contentHash": "93b51b64114153b943ded7fa4cea8e62d28ddf819c14f9749dbb3f56e5016067", "sourceKind": "component_definition", "sourceId": "pdx-inline-searchable-select", "corpusVersion": "1.0.0" } ] }, "pdx-inline-select": { "id": "pdx-inline-select", "description": "Select compacto para uso em barras de filtro dinâmico.", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-select", "friendlyName": "Inline Select", "icon": "filter_alt", "tags": [ "widget", "field", "select", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-select/inline-select.metadata.ts", "exportName": "PDX_INLINE_SELECT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-select\nSelector: pdx-inline-select\nFriendly Name: Inline Select\nDescription: Select compacto para uso em barras de filtro dinâmico.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, select, filter, inline\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-select/inline-select.metadata.ts", "contentHash": "c287fb03d3d29dac121860ee8e33bf0f0ab58e77344cd67a87f9735d0dba063b", "sourceKind": "component_definition", "sourceId": "pdx-inline-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-inline-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-select | controlType: inlineSelect | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"select\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por status ou categoria com lista curta\",\n \"examplePrompts\": [\n \"crie um filtro inline de status\",\n \"adicione inlineSelect para categoria principal\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"status\",\n \"label\": \"Status\",\n \"placeholder\": \"Selecionar\",\n \"controlType\": \"inlineSelect\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de status\"\n },\n \"options\": [\n {\n \"key\": \"Aberto\",\n \"value\": \"open\"\n },\n {\n \"key\": \"Em analise\",\n \"value\": \"triage\"\n },\n {\n \"key\": \"Concluido\",\n \"value\": \"done\"\n }\n ],\n \"emptyOptionText\": \"Todos os status\",\n \"ariaLabel\": \"Filtro de status\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-select.json", "contentHash": "09ff4943d73c508230d9909d394ca6a27da92460e8407e950b5c5db435c92085", "sourceKind": "component_definition", "sourceId": "pdx-inline-select", "corpusVersion": "1.0.0" } ] }, "pdx-inline-sentiment": { "id": "pdx-inline-sentiment", "description": "Filtro inline de sentimento com barra colorida e cards emoji configuráveis por metadados.", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-sentiment", "friendlyName": "Inline Sentiment", "icon": "mood", "tags": [ "widget", "field", "sentiment", "emoji", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-sentiment/inline-sentiment.metadata.ts", "exportName": "PDX_INLINE_SENTIMENT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-sentiment\nSelector: pdx-inline-sentiment\nFriendly Name: Inline Sentiment\nDescription: Filtro inline de sentimento com barra colorida e cards emoji configuráveis por metadados.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, sentiment, emoji, filter, inline\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-sentiment/inline-sentiment.metadata.ts", "contentHash": "1354b8904834cf8aca63d709fb1ef81341cd6d2ce8b49a7d799a400f16e51fe1", "sourceKind": "component_definition", "sourceId": "pdx-inline-sentiment", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-inline-sentiment", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-sentiment | controlType: inlineSentiment | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-sentiment\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"sentiment\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por polaridade ou humor quando texto e semantica visual se reforcam\",\n \"avoidWhen\": \"o dominio usa apenas enum simples e a interface dependeria de emoji ou cor para ser entendida\",\n \"examplePrompts\": [\n \"crie um filtro inline de sentimento\",\n \"adicione inlineSentiment para classificar humor do atendimento\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"sentiment\",\n \"label\": \"Sentimento\",\n \"placeholder\": \"Selecionar sentimento\",\n \"controlType\": \"inlineSentiment\",\n \"sentimentOptions\": [\n { \"id\": \"bad\", \"label\": \"Ruim\", \"value\": \"bad\", \"emoji\": \":(\", \"color\": \"#f59e0b\" },\n { \"id\": \"neutral\", \"label\": \"Neutro\", \"value\": \"neutral\", \"emoji\": \":|\", \"color\": \"#9ca3af\" },\n { \"id\": \"good\", \"label\": \"Bom\", \"value\": \"good\", \"emoji\": \":)\", \"color\": \"#22c55e\" }\n ],\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true\n },\n \"ariaLabel\": \"Filtro de sentimento\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-sentiment.json", "contentHash": "5fa673d42d45ce8303a18638d222ce8f8ba43c495f5450240b314d7bda52b4b9", "sourceKind": "component_definition", "sourceId": "pdx-inline-sentiment", "corpusVersion": "1.0.0" } ] }, "pdx-inline-time": { "id": "pdx-inline-time", "description": "Timepicker compacto para barras de filtro dinâmico, com largura por conteúdo e seleção inline em lista ou colunas Hor/Min/Seg.", "inputs": [ { "name": "metadata", "type": "MaterialTimepickerMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-time", "friendlyName": "Inline Time", "icon": "schedule", "tags": [ "widget", "field", "time", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-time/inline-time.metadata.ts", "exportName": "PDX_INLINE_TIME_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-time\nSelector: pdx-inline-time\nFriendly Name: Inline Time\nDescription: Timepicker compacto para barras de filtro dinâmico, com largura por conteúdo e seleção inline em lista ou colunas Hor/Min/Seg.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, time, filter, inline\nInputs:\n - metadata (MaterialTimepickerMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-time/inline-time.metadata.ts", "contentHash": "2ae85e22937b69c9078ed01ffd39deea0e0e103affd4e32a3154799a9d911d75", "sourceKind": "component_definition", "sourceId": "pdx-inline-time", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date\",\n \"title\": \"Date controls\",\n \"description\": \"Profile for single date, datetime, month, week, year and time picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-date-input\",\n \"pdx-datetime-local-input\",\n \"pdx-inline-date\",\n \"pdx-inline-time\",\n \"pdx-material-datepicker\",\n \"pdx-material-timepicker\",\n \"pdx-month-input\",\n \"pdx-time-input\",\n \"pdx-week-input\",\n \"pdx-year-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date/time metadata paths such as min, max, timezone, locale and format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.date.configure\",\n \"title\": \"Configure date or time field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"timezone\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"temporal-bounds-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.timezone\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.format\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-min-max\",\n \"request\": \"Limit the date field to the current year in Sao Paulo timezone.\",\n \"operationId\": \"field.date.configure\",\n \"params\": {\n \"min\": \"2026-01-01\",\n \"max\": \"2026-12-31\",\n \"timezone\": \"America/Sao_Paulo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "08eab5ad75f996b139ebddd730883a5cd6895567e2c3a16cafc4ddf60e53b185", "sourceKind": "component_definition", "sourceId": "pdx-inline-time", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-time | controlType: inlineTime | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-time\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"time\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por horario pontual dentro da jornada\",\n \"examplePrompts\": [\n \"crie um filtro inline de horario\",\n \"adicione inlineTime para hora de atendimento\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"startTime\",\n \"label\": \"Horario\",\n \"placeholder\": \"HH:mm\",\n \"controlType\": \"inlineTime\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de horario\"\n },\n \"stepMinute\": 15,\n \"defaultValue\": \"09:00\",\n \"ariaLabel\": \"Filtro de horario\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-time.json", "contentHash": "c68443bafd14e74c13ba7fb01809e6630a554df5c1fe713c8512658bb58bb07e", "sourceKind": "component_definition", "sourceId": "pdx-inline-time", "corpusVersion": "1.0.0" } ] }, "pdx-inline-time-range": { "id": "pdx-inline-time-range", "description": "Intervalo de horário compacto para barras de filtro dinâmico, com pill responsiva, slider de faixa, atalhos rápidos e popover não-modal com foco de teclado tratado para uso corporativo.", "inputs": [ { "name": "metadata", "type": "MaterialTimeRangeMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-time-range", "friendlyName": "Inline Time Range", "icon": "schedule", "tags": [ "widget", "field", "time", "time-range", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-time-range/inline-time-range.metadata.ts", "exportName": "PDX_INLINE_TIME_RANGE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-time-range\nSelector: pdx-inline-time-range\nFriendly Name: Inline Time Range\nDescription: Intervalo de horário compacto para barras de filtro dinâmico, com pill responsiva, slider de faixa, atalhos rápidos e popover não-modal com foco de teclado tratado para uso corporativo.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, time, time-range, filter, inline\nInputs:\n - metadata (MaterialTimeRangeMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-time-range/inline-time-range.metadata.ts", "contentHash": "c6d7ba9d83e7b9141b267bb4fb8e15f4f7ed7790893a0689f98e3cd180f17db0", "sourceKind": "component_definition", "sourceId": "pdx-inline-time-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"time-range\",\n \"title\": \"Time range controls\",\n \"description\": \"Profile for time range controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-time-range\",\n \"pdx-material-time-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Time range metadata paths such as start/end fields, step minutes and timezone.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.timeRange.configure\",\n \"title\": \"Configure time range field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"startField\": {\n \"type\": \"string\"\n },\n \"endField\": {\n \"type\": \"string\"\n },\n \"stepMinutes\": {\n \"type\": \"number\"\n },\n \"timezone\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"time-range-fields-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.startField\",\n \"fieldMetadata.endField\",\n \"fieldMetadata.stepMinutes\",\n \"fieldMetadata.timezone\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"time-range-fields-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP014\",\n \"description\": \"Time range controls require distinct start/end field semantics and valid interval steps.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-time-range-step\",\n \"request\": \"Configure a time range with fifteen minute increments.\",\n \"operationId\": \"field.timeRange.configure\",\n \"params\": {\n \"stepMinutes\": 15\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e8697f568287572f2b796776880dd70ac1d92b971f6ff2a4b27f457cc46fe764", "sourceKind": "component_definition", "sourceId": "pdx-inline-time-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-time-range | controlType: inlineTimeRange | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-time-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"time-range\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por janela de horario de operacao\",\n \"examplePrompts\": [\n \"crie um filtro inline de faixa horaria\",\n \"adicione inlineTimeRange para turno\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"serviceWindow\",\n \"label\": \"Janela horaria\",\n \"placeholder\": \"08:00 - 18:00\",\n \"controlType\": \"inlineTimeRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de janela horaria\"\n },\n \"defaultValue\": {\n \"start\": \"08:00\",\n \"end\": \"18:00\"\n },\n \"stepMinute\": 15,\n \"validators\": {\n \"minDistance\": 30,\n \"maxDistance\": 720\n },\n \"inlineTimeTrackShifts\": [\n {\n \"id\": \"manha\",\n \"label\": \"Manha\",\n \"start\": \"06:00\",\n \"end\": \"12:00\"\n },\n {\n \"id\": \"comercial\",\n \"label\": \"Comercial\",\n \"start\": \"09:00\",\n \"end\": \"18:00\"\n },\n {\n \"id\": \"noturno\",\n \"label\": \"Noturno\",\n \"start\": \"18:00\",\n \"end\": \"23:00\"\n }\n ],\n \"ariaLabel\": \"Filtro de janela horaria\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-time-range.json", "contentHash": "126cd476edb9326d8d8629c6a34e3fe9dcf864eca49bda4ff65e06b0d92f6a58", "sourceKind": "component_definition", "sourceId": "pdx-inline-time-range", "corpusVersion": "1.0.0" } ] }, "pdx-inline-toggle": { "id": "pdx-inline-toggle", "description": "Toggle compacto para filtros booleanos em barras dinâmicas.", "inputs": [ { "name": "metadata", "type": "MaterialToggleMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-toggle", "friendlyName": "Inline Toggle", "icon": "toggle_on", "tags": [ "widget", "field", "toggle", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-toggle/inline-toggle.metadata.ts", "exportName": "PDX_INLINE_TOGGLE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-toggle\nSelector: pdx-inline-toggle\nFriendly Name: Inline Toggle\nDescription: Toggle compacto para filtros booleanos em barras dinâmicas.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, toggle, filter, inline\nInputs:\n - metadata (MaterialToggleMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-toggle/inline-toggle.metadata.ts", "contentHash": "38bc3b068141349500c799c1222ff0a47f44997949a8e9812a9111e3702e8ad7", "sourceKind": "component_definition", "sourceId": "pdx-inline-toggle", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"toggle\",\n \"title\": \"Toggle controls\",\n \"description\": \"Profile for boolean toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-toggle\",\n \"pdx-material-slide-toggle\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Boolean metadata paths such as true label, false label and default value.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.toggle.configure\",\n \"title\": \"Configure toggle field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"trueLabel\": {\n \"type\": \"string\"\n },\n \"falseLabel\": {\n \"type\": \"string\"\n },\n \"defaultValue\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"boolean-toggle-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.trueLabel\",\n \"fieldMetadata.falseLabel\",\n \"fieldMetadata.defaultValue\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"boolean-toggle-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP015\",\n \"description\": \"Toggle controls must preserve boolean value semantics and not serialize labels as submitted values.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-toggle-labels\",\n \"request\": \"Set yes/no labels for a toggle without changing boolean submission.\",\n \"operationId\": \"field.toggle.configure\",\n \"params\": {\n \"trueLabel\": \"Yes\",\n \"falseLabel\": \"No\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e936b67bb4d83c38589cd2bbac1eb0acf8a35e18ff28cc6b8155f753d188d449", "sourceKind": "component_definition", "sourceId": "pdx-inline-toggle", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-toggle | controlType: inlineToggle | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-toggle\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"toggle\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar condicoes binarias do tipo sim/nao\",\n \"examplePrompts\": [\n \"crie um filtro inline booleano\",\n \"adicione inlineToggle para somente ativos\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"onlyActive\",\n \"label\": \"Somente ativos\",\n \"placeholder\": \"Ativo\",\n \"controlType\": \"inlineToggle\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"defaultValue\": true,\n \"ariaLabel\": \"Filtro somente ativos\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-toggle.json", "contentHash": "81c910b16ec6f4175af3b18dab276da9eadbce5c04fa698c2c44a8a294b2dd96", "sourceKind": "component_definition", "sourceId": "pdx-inline-toggle", "corpusVersion": "1.0.0" } ] }, "pdx-inline-tree-select": { "id": "pdx-inline-tree-select", "description": "Seleção hierárquica compacta para barras de filtro dinâmico, com busca no popover e resumo em pill.", "inputs": [ { "name": "metadata", "type": "MaterialTreeSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-tree-select", "friendlyName": "Inline Tree Select", "icon": "account_tree", "tags": [ "widget", "field", "tree", "select", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-tree-select/inline-tree-select.metadata.ts", "exportName": "PDX_INLINE_TREE_SELECT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-tree-select\nSelector: pdx-inline-tree-select\nFriendly Name: Inline Tree Select\nDescription: Seleção hierárquica compacta para barras de filtro dinâmico, com busca no popover e resumo em pill.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, tree, select, filter, inline\nInputs:\n - metadata (MaterialTreeSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-tree-select/inline-tree-select.metadata.ts", "contentHash": "9672a866b41e0c6c16f8adfff72ccff004af7da1fdc06288f532a8ec5809cd8f", "sourceKind": "component_definition", "sourceId": "pdx-inline-tree-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"tree-select\",\n \"title\": \"Tree select controls\",\n \"description\": \"Profile for hierarchical tree select controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-tree-select\",\n \"pdx-material-multi-select-tree\",\n \"pdx-material-tree-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.treeSelect.configure\",\n \"title\": \"Configure tree select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"nodeIdField\": {\n \"type\": \"string\"\n },\n \"parentIdField\": {\n \"type\": \"string\"\n },\n \"childrenField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"lazyLoad\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"tree-node-identity-valid\",\n \"tree-option-source-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.nodeIdField\",\n \"fieldMetadata.parentIdField\",\n \"fieldMetadata.childrenField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.lazyLoad\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"tree-node-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP008\",\n \"description\": \"Tree controls require stable node identity and valid parent/children references.\"\n },\n {\n \"validatorId\": \"tree-option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP009\",\n \"description\": \"Tree option sources must expose hierarchical data compatible with the configured node fields.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-tree-select\",\n \"request\": \"Configure tree select with id, parentId and children fields.\",\n \"operationId\": \"field.treeSelect.configure\",\n \"params\": {\n \"nodeIdField\": \"id\",\n \"parentIdField\": \"parentId\",\n \"childrenField\": \"children\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "67bf3826cde32728907417376c021d9c845f4c51dccf855a8c4cae621c905234", "sourceKind": "component_definition", "sourceId": "pdx-inline-tree-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-tree-select | controlType: inlineTreeSelect | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-tree-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"tree-select\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por hierarquia de dominio, area e subarea com selecao unica e arvore curta\",\n \"avoidWhen\": \"a arvore eh profunda, exige exploracao de varios ramos ou a decisao depende de revisar a estrutura completa\",\n \"examplePrompts\": [\n \"crie um filtro inline de arvore para departamentos\",\n \"adicione inlineTreeSelect para estrutura organizacional\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"departmentPath\",\n \"label\": \"Departamento\",\n \"placeholder\": \"Selecionar no\",\n \"controlType\": \"inlineTreeSelect\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de departamento\"\n },\n \"options\": [\n {\n \"key\": \"Operacoes\",\n \"value\": \"ops\",\n \"children\": [\n {\n \"key\": \"Atendimento\",\n \"value\": \"ops-support\"\n },\n {\n \"key\": \"Logistica\",\n \"value\": \"ops-logistics\"\n }\n ]\n },\n {\n \"key\": \"Tecnologia\",\n \"value\": \"tech\",\n \"children\": [\n {\n \"key\": \"Plataforma\",\n \"value\": \"tech-platform\"\n },\n {\n \"key\": \"Aplicacoes\",\n \"value\": \"tech-apps\"\n }\n ]\n }\n ],\n \"treeConfig\": {\n \"childrenField\": \"children\",\n \"labelField\": \"key\",\n \"valueField\": \"value\"\n },\n \"ariaLabel\": \"Filtro hierarquico de departamento\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-tree-select.json", "contentHash": "842417abc407df0ad21ccfd4fc6c4334da81b96f0ae8131ecfa3dd4e1f0f2345", "sourceKind": "component_definition", "sourceId": "pdx-inline-tree-select", "corpusVersion": "1.0.0" } ] }, "pdx-inline-year-range": { "id": "pdx-inline-year-range", "description": "Faixa anual compacta para filtros inline corporativos, com slider dedicado, presets por período recente e leitura semântica orientada a analytics.", "inputs": [ { "name": "metadata", "type": "InlineYearRangeMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-inline-year-range", "friendlyName": "Inline Year Range", "icon": "calendar_today", "tags": [ "widget", "field", "year", "range", "filter", "inline" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/inline-year-range/inline-year-range.metadata.ts", "exportName": "PDX_INLINE_YEAR_RANGE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-inline-year-range\nSelector: pdx-inline-year-range\nFriendly Name: Inline Year Range\nDescription: Faixa anual compacta para filtros inline corporativos, com slider dedicado, presets por período recente e leitura semântica orientada a analytics.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, year, range, filter, inline\nInputs:\n - metadata (InlineYearRangeMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/inline-year-range/inline-year-range.metadata.ts", "contentHash": "6acf95494326d57bb09107094b7a1f415c80c051c7f18f45e670100d92b25f69", "sourceKind": "component_definition", "sourceId": "pdx-inline-year-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date-range\",\n \"title\": \"Date range controls\",\n \"description\": \"Profile for date range, month range, year range, period and relative-period controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-date-range\",\n \"pdx-inline-month-range\",\n \"pdx-inline-period-range\",\n \"pdx-inline-relative-period\",\n \"pdx-inline-year-range\",\n \"pdx-material-date-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date range metadata paths such as start/end field mapping, min/max and presets.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.dateRange.configure\",\n \"title\": \"Configure date range field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"startField\": {\n \"type\": \"string\"\n },\n \"endField\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"presets\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"date-range-fields-valid\",\n \"temporal-bounds-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.startField\",\n \"fieldMetadata.endField\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.presets\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"date-range-fields-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP013\",\n \"description\": \"Date range controls require distinct start/end field semantics and ordered submitted values.\"\n },\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-range-fields\",\n \"request\": \"Use createdFrom and createdTo as the date range field names.\",\n \"operationId\": \"field.dateRange.configure\",\n \"params\": {\n \"startField\": \"createdFrom\",\n \"endField\": \"createdTo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "341f9bca8da5ec291232bdda90ba13821bb60134fc7892d9e14078948696da03", "sourceKind": "component_definition", "sourceId": "pdx-inline-year-range", "corpusVersion": "1.0.0" } ] }, "pdx-material-async-select": { "id": "pdx-material-async-select", "description": "Select com carregamento assíncrono de opções.", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-async-select", "friendlyName": "Async Select (Material)", "icon": "cloud_download", "tags": [ "widget", "field", "select", "async", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-async-select/material-async-select.metadata.ts", "exportName": "PDX_MATERIAL_ASYNC_SELECT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-async-select\nSelector: pdx-material-async-select\nFriendly Name: Async Select (Material)\nDescription: Select com carregamento assíncrono de opções.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, select, async, material\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-async-select/material-async-select.metadata.ts", "contentHash": "84ed8baf0ed74946d0a602a53e3d9bcdf8f35ee9a1f0a21e72d2a4e3d0fb9af0", "sourceKind": "component_definition", "sourceId": "pdx-material-async-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-material-async-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-async-select | controlType: async-select\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-async-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"base\"\n ],\n \"useWhen\": \"criar campo async-select\",\n \"examplePrompts\": [\n \"crie um campo async-select\",\n \"adicione um async-select ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_async_select\",\n \"label\": \"Example async-select\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"async-select\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"loadOn\": \"open\",\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n },\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-async-select.json", "contentHash": "20f78cec3401b17185b4d7103ecbd090f02323887b0e070ea75937efff9aa66c", "sourceKind": "component_definition", "sourceId": "pdx-material-async-select", "corpusVersion": "1.0.0" } ] }, "pdx-material-autocomplete": { "id": "pdx-material-autocomplete", "description": "Campo com sugestões e carregamento remoto de opções.", "inputs": [ { "name": "metadata", "type": "MaterialAutocompleteMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-autocomplete", "friendlyName": "Autocomplete (Material)", "icon": "search", "tags": [ "widget", "field", "autocomplete", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-autocomplete/material-autocomplete.metadata.ts", "exportName": "PDX_MATERIAL_AUTOCOMPLETE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-autocomplete\nSelector: pdx-material-autocomplete\nFriendly Name: Autocomplete (Material)\nDescription: Campo com sugestões e carregamento remoto de opções.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, autocomplete, material\nInputs:\n - metadata (MaterialAutocompleteMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-autocomplete/material-autocomplete.metadata.ts", "contentHash": "4e165312e1b763863f1f42c5eb37d24579b06755e6af7141a94306fb88de8f6d", "sourceKind": "component_definition", "sourceId": "pdx-material-autocomplete", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-material-autocomplete", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-autocomplete | controlType: autoComplete\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-autocomplete\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo autoComplete\",\n \"examplePrompts\": [\n \"crie um campo autoComplete\",\n \"adicione um autoComplete ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_autoComplete\",\n \"label\": \"Example autoComplete\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"autoComplete\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"loadOn\": \"open\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-autocomplete.json", "contentHash": "f07fbd110542ce2b6aab0f7b157b45314646daea9d90dbd98a1cc16920bffff2", "sourceKind": "component_definition", "sourceId": "pdx-material-autocomplete", "corpusVersion": "1.0.0" } ] }, "pdx-material-avatar": { "id": "pdx-material-avatar", "description": "praxis.dynamicFields.editorial.avatar.description", "inputs": [ { "name": "metadata", "type": "FieldMetadata", "required": false }, { "name": "imageSrc", "type": "string", "required": false }, { "name": "imageAlt", "type": "string", "required": false }, { "name": "initials", "type": "string", "required": false }, { "name": "name", "type": "string", "required": false }, { "name": "icon", "type": "string | SafeHtml | { name?: string; svg?: string; fontClass?: string }", "required": false }, { "name": "defaultIcon", "type": "string | SafeHtml | { name?: string; svg?: string; fontClass?: string }", "required": false }, { "name": "themeColor", "type": "'primary'|'secondary'|'tertiary'|'base'|'info'|'success'|'warning'|'error'|'dark'|'light'|'inverse'|'none'", "required": false }, { "name": "rounded", "type": "'full'|'large'|'medium'|'small'|'none'", "required": false }, { "name": "size", "type": "'xsmall'|'small'|'medium'|'large'|'xlarge'|'xxlarge'|'none'", "required": false }, { "name": "fillMode", "type": "'solid'|'outline'|'none'", "required": false }, { "name": "border", "type": "boolean", "required": false }, { "name": "status", "type": "'online'|'offline'|'busy'|'away'|'verified'|'none'", "required": false }, { "name": "statusLabel", "type": "string", "required": false }, { "name": "badge", "type": "string | number", "required": false }, { "name": "badgeLabel", "type": "string", "required": false }, { "name": "emphasis", "type": "'none'|'ring'|'halo'", "required": false }, { "name": "emphasisColor", "type": "'primary'|'secondary'|'tertiary'|'base'|'info'|'success'|'warning'|'error'|'dark'|'light'|'inverse'|'none'", "required": false }, { "name": "emphasisLabel", "type": "string", "required": false }, { "name": "initialsMaxLength", "type": "number", "required": false }, { "name": "tooltip", "type": "string", "required": false }, { "name": "ariaLabel", "type": "string", "required": false }, { "name": "class", "type": "string", "required": false }, { "name": "style", "type": "NgStyle | Record", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": "FieldMetadata", "selector": "pdx-material-avatar", "friendlyName": "praxis.dynamicFields.editorial.avatar.friendlyName", "icon": "person", "tags": [ "widget", "field", "avatar", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-avatar/material-avatar.metadata.ts", "exportName": "PDX_MATERIAL_AVATAR_COMPONENT_METADATA", "capabilities": [ { "path": "id", "category": "identity", "valueKind": "string", "description": "Identificador unico da instancia do componente.", "intentExamples": [ "id do componente", "definir id fixo" ] }, { "path": "version", "category": "identity", "valueKind": "string", "description": "Versao do schema de metadata (migracao).", "intentExamples": [ "versao do metadata", "ajustar versao" ] }, { "path": "context", "category": "identity", "valueKind": "enum", "allowedValues": [ "form", "filter", "table", "dialog", "standalone" ], "description": "Contexto de uso do componente (form/filter/table/dialog/standalone).", "intentExamples": [ "contexto form", "usar em tabela" ] }, { "path": "createdAt", "category": "misc", "valueKind": "string", "description": "Timestamp de criacao (ISO).", "safetyNotes": "Valor de auditoria; preferir preenchimento pelo host." }, { "path": "updatedAt", "category": "misc", "valueKind": "string", "description": "Timestamp de atualizacao (ISO).", "safetyNotes": "Valor de auditoria; preferir preenchimento pelo host." }, { "path": "tags", "category": "identity", "valueKind": "array", "description": "Tags para categorizacao e busca.", "intentExamples": [ "tag para busca", "categorizar campo" ] }, { "path": "cssClass", "category": "appearance", "valueKind": "string", "description": "Classe CSS aplicada ao host do componente.", "intentExamples": [ "classe custom", "aplicar classe" ] }, { "path": "style", "category": "appearance", "valueKind": "object", "description": "Estilos inline (objeto CSS).", "safetyNotes": "Validar chaves e valores CSS permitidos." }, { "path": "dataAttributes", "category": "data", "valueKind": "object", "description": "Data attributes para teste/analytics.", "intentExamples": [ "data-testid", "atributos de tracking" ] }, { "path": "name", "category": "identity", "valueKind": "string", "description": "Identificador único do campo. Essencial para binding.", "critical": true, "intentExamples": [ "nomear campo como email", "id do campo" ] }, { "path": "label", "category": "identity", "valueKind": "string", "description": "Rótulo principal exibido para o usuário.", "intentExamples": [ "alterar label", "mudar texto do rótulo" ] }, { "path": "placeholder", "category": "identity", "valueKind": "string", "description": "Texto temporário exibido quando vazio.", "intentExamples": [ "adicionar placeholder", "texto de ajuda no input" ] }, { "path": "hint", "category": "identity", "valueKind": "string", "description": "Texto de ajuda exibido abaixo do campo.", "intentExamples": [ "colocar dica", "ajuda no rodapé do campo" ] }, { "path": "helpText", "category": "identity", "valueKind": "string", "description": "Texto semântico de ajuda publicado pelo schema/DTO.", "intentExamples": [ "explicar regra de negócio do campo", "ajuda vinda do backend" ] }, { "path": "tooltip", "category": "identity", "valueKind": "string", "description": "Texto exibido ao passar o mouse.", "intentExamples": [ "adicionar tooltip" ] }, { "path": "tooltipOnHover", "category": "identity", "valueKind": "boolean", "description": "Habilita apresentação do tooltip no hover quando suportado pelo renderer.", "intentExamples": [ "mostrar tooltip ao passar o mouse", "ativar dica no hover" ] }, { "path": "description", "category": "identity", "valueKind": "string", "description": "Descrição detalhada (usada em documentação ou helps extensos).", "intentExamples": [ "descrição completa do campo", "texto explicativo longo", "documentação do input" ] }, { "path": "selectionMode", "category": "behavior", "valueKind": "enum", "allowedValues": [ "boolean", "single", "multiple" ], "description": "Semântica de seleção explícita para controles de escolha.", "intentExamples": [ "checkbox booleano", "radio de escolha única", "grupo múltiplo" ] }, { "path": "variant", "category": "appearance", "valueKind": "string", "description": "Variante visual/semântica do controle.", "intentExamples": [ "variante consent", "modo compact", "apresentação em tiles" ] }, { "path": "density", "category": "appearance", "valueKind": "enum", "allowedValues": [ "compact", "comfortable", "spacious" ], "description": "Densidade visual do shell do controle.", "intentExamples": [ "deixar mais compacto", "usar densidade confortável", "mais espaçado" ] }, { "path": "links", "category": "identity", "valueKind": "array", "description": "Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.", "intentExamples": [ "adicionar link da política", "incluir termos de uso", "anexar link institucional" ] }, { "path": "group", "category": "identity", "valueKind": "string", "description": "Agrupador lógico do campo.", "intentExamples": [ "agrupar em Dados Pessoais", "colocar no grupo de endereço", "categoria do campo" ] }, { "path": "order", "category": "layout", "valueKind": "number", "description": "Ordem de exibição do campo.", "intentExamples": [ "mover para o final", "reordenar campo", "exibir primeiro", "posição 3" ] }, { "path": "width", "category": "layout", "valueKind": "string", "description": "Largura do campo (ex: 50%, 100px).", "intentExamples": [ "campo meia largura", "largura fixa 200px", "ocupar 50%", "width total" ] }, { "path": "isFlex", "category": "layout", "valueKind": "boolean", "description": "Se true, usa flex-grow para preencher espaço.", "intentExamples": [ "preencher espaço sobrando", "campo flexível", "expandir para caber" ] }, { "path": "controlType", "category": "behavior", "valueKind": "enum", "description": "Tipo do componente de UI (input, select, datepicker, etc).", "critical": true, "safetyNotes": "Mudar controlType pode invalidar propriedades específicas do componente anterior. Aplique o overlay de microcomponente correspondente.", "intentExamples": [ "mudar para select", "usar datepicker", "transformar em checkbox", "tipo do controle" ] }, { "path": "dataType", "category": "data", "valueKind": "enum", "description": "Tipo de dado do campo (text, number, date, etc).", "intentExamples": [ "tipo de dado numero", "campo de data" ] }, { "path": "source", "category": "data", "valueKind": "enum", "allowedValues": [ "schema", "local" ], "description": "Origem semântica do campo. Use local para campos do host que não vêm do schema backend.", "intentExamples": [ "campo local", "campo auxiliar do host", "campo que não vem do schema" ], "safetyNotes": "Não marque como local um campo que exista no schema backend; remova a semântica local quando houver colisão com campo server-backed." }, { "path": "transient", "category": "data", "valueKind": "boolean", "description": "Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.", "intentExamples": [ "campo temporário", "campo transient", "não enviar no payload", "usar apenas na UI" ], "safetyNotes": "Campos transient continuam participando de UI, validação, regras, visibilidade e valueChange; eles apenas saem do payload persistido por padrão." }, { "path": "submitPolicy", "category": "behavior", "valueKind": "enum", "allowedValues": [ "include", "omit", "includeWhenDirty" ], "description": "Política de submit para sobrescrever o padrão de campos locais/transient.", "intentExamples": [ "omitir do submit", "enviar mesmo sendo local", "enviar apenas se alterado" ], "safetyNotes": "Use omit para nunca persistir, include para enviar sempre e includeWhenDirty apenas quando o controle estiver dirty." }, { "path": "materialDesign.appearance", "category": "appearance", "valueKind": "enum", "allowedValues": [ "fill", "outline" ], "description": "Aparência do campo Material (fill/outline).", "intentExamples": [ "estilo outline", "aparência preenchida", "campo com borda" ] }, { "path": "materialDesign.color", "category": "appearance", "valueKind": "enum", "allowedValues": [ "primary", "accent", "warn" ], "description": "Tema de cor Material (primary/accent/warn).", "intentExamples": [ "cor primária", "destacar com accent" ] }, { "path": "materialDesign.floatLabel", "category": "appearance", "valueKind": "enum", "allowedValues": [ "auto", "always", "never" ], "description": "Comportamento do rótulo flutuante.", "intentExamples": [ "label sempre flutuando", "nunca flutuar label" ] }, { "path": "materialDesign.subscriptSizing", "category": "appearance", "valueKind": "enum", "allowedValues": [ "fixed", "dynamic" ], "description": "Estratégia de sizing do subscript (erros/hints)." }, { "path": "materialDesign.hideRequiredMarker", "category": "appearance", "valueKind": "boolean", "description": "Oculta o asterisco de campo obrigatório." }, { "path": "materialDesign.density", "category": "appearance", "valueKind": "enum", "allowedValues": [ "comfortable", "compact", "dense" ], "description": "Densidade do campo Material." }, { "path": "materialDesign.disableRipple", "category": "appearance", "valueKind": "boolean", "description": "Desativa ripple/ondulação em componentes Material." }, { "path": "materialDesign.customPalette", "category": "appearance", "valueKind": "object", "description": "Override de paleta (primary/accent/warn).", "safetyNotes": "Use cores válidas; validar contra o tema." }, { "path": "materialDesign.animations", "category": "appearance", "valueKind": "object", "description": "Configuração de animações (disable, duration, easing)." }, { "path": "prefixIcon", "category": "appearance", "valueKind": "string", "description": "Ícone exibido antes do valor.", "intentExamples": [ "ícone de usuário no início", "prefixar ícone", "imagem antes do texto" ] }, { "path": "suffixIcon", "category": "appearance", "valueKind": "string", "description": "Ícone exibido depois do valor.", "intentExamples": [ "ícone de busca no final", "sufixar ícone", "botão de ação no fim" ] }, { "path": "iconPosition", "category": "appearance", "valueKind": "enum", "allowedValues": [ "start", "end" ], "description": "Posição preferencial do ícone principal.", "intentExamples": [ "ícone à esquerda", "posicionar ícone no fim" ] }, { "path": "iconSize", "category": "appearance", "valueKind": "enum", "allowedValues": [ "small", "medium", "large" ], "description": "Tamanho do ícone.", "intentExamples": [ "ícone pequeno", "aumentar tamanho do ícone", "ícone grande" ] }, { "path": "iconColor", "category": "appearance", "valueKind": "string", "description": "Cor semântica ou token de cor aplicado ao ícone principal.", "intentExamples": [ "ícone em cor primária", "usar token do tema no ícone" ] }, { "path": "iconClass", "category": "appearance", "valueKind": "string", "description": "Classe CSS controlada pelo host para o ícone principal.", "intentExamples": [ "usar classe de ícone outlined", "aplicar classe corporativa" ] }, { "path": "iconStyle", "category": "appearance", "valueKind": "string", "description": "Estilo visual semântico do ícone quando o renderer suportar variações.", "intentExamples": [ "usar ícone arredondado", "aplicar estilo filled" ] }, { "path": "iconFontSize", "category": "appearance", "valueKind": "string", "description": "Tamanho tipográfico do ícone principal.", "intentExamples": [ "ícone com 18px", "ajustar tamanho do ícone" ] }, { "path": "valuePresentation", "category": "appearance", "valueKind": "object", "description": "Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.", "safetyNotes": "Preferir este contrato a formatadores legados quando a intencao for apresentacao de valor.", "intentExamples": [ "mostrar como moeda", "formatar como data longa", "exibir percentual" ] }, { "path": "presentation", "category": "appearance", "valueKind": "object", "description": "Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.", "safetyNotes": "Use apenas semantica declarativa; nao incluir CSS arbitrario, HTML, comandos ou efeitos mutaveis.", "intentExamples": [ "status com icone", "badge de pendente", "campo em tom warning" ] }, { "path": "presentation.presenter", "category": "appearance", "valueKind": "enum", "allowedValues": [ "text", "badge", "chip", "status", "iconValue", "progress", "rating", "microVisualization" ], "description": "Tipo semantico de renderizacao em modo apresentacao.", "intentExamples": [ "renderizar como status", "usar chip", "mostrar icone com valor" ] }, { "path": "presentation.tone", "category": "appearance", "valueKind": "enum", "allowedValues": [ "neutral", "info", "success", "warning", "danger" ], "description": "Tom semantico mapeado pelo consumidor para tokens de tema.", "intentExamples": [ "tom de sucesso", "tom de alerta", "tom de erro" ] }, { "path": "presentation.appearance", "category": "appearance", "valueKind": "enum", "allowedValues": [ "plain", "soft", "outlined", "filled" ], "description": "Nivel de enfase visual do apresentador.", "intentExamples": [ "status preenchido", "badge contornado", "chip suave" ] }, { "path": "presentation.icon", "category": "appearance", "valueKind": "string", "description": "Nome de icone Material Symbols usado pelo apresentador semantico.", "intentExamples": [ "icone lock", "icone payments", "icone schedule" ] }, { "path": "presentation.label", "category": "identity", "valueKind": "string", "description": "Rotulo semantico exibido por apresentadores como status, badge ou chip.", "intentExamples": [ "rotulo Bloqueado", "texto Aprovado", "status Aguardando aprovacao" ] }, { "path": "presentation.badge", "category": "appearance", "valueKind": "string", "description": "Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.", "intentExamples": [ "badge alto valor", "marcador D+35", "sinalizar revisao executiva" ] }, { "path": "presentation.valuePresentation", "category": "appearance", "valueKind": "object", "description": "Override de formatacao aplicado apenas pela superficie de apresentacao.", "safetyNotes": "Nao altera o valor real do FormControl nem o payload de submit." }, { "path": "presentation.visualization", "category": "appearance", "valueKind": "object", "description": "Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.", "safetyNotes": "Exige fallback textual e nao pode conter opcoes de ECharts, HTML, SVG bruto, CSS ou comandos.", "intentExamples": [ "micro chart de SLA", "barra empilhada em celula", "bullet chart de orcamento", "fluxo compacto de aprovacao" ] }, { "path": "presentation.visualization.kind", "category": "appearance", "valueKind": "enum", "allowedValues": [ "line", "area", "column", "comparison", "stackedBar", "radial", "harveyBall", "bullet", "delta", "processFlow" ], "description": "Tipo semantico da micro visualizacao de apresentacao.", "intentExamples": [ "comparison", "stackedBar", "bullet", "processFlow" ] }, { "path": "presentation.visualization.surface", "category": "layout", "valueKind": "enum", "allowedValues": [ "table-cell", "list-item", "object-header", "card-summary", "form-presentation" ], "description": "Superficie alvo usada para aplicar regras de densidade e fallback.", "intentExamples": [ "table-cell", "list-item", "form-presentation" ] }, { "path": "presentation.visualization.size", "category": "layout", "valueKind": "enum", "allowedValues": [ "xs", "sm", "md", "lg", "responsive" ], "description": "Tamanho semantico da micro visualizacao.", "intentExamples": [ "xs em tabela", "md em header", "responsive em card" ] }, { "path": "presentation.visualization.fallbackText", "category": "accessibility", "valueKind": "string", "description": "Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.", "safetyNotes": "Deve explicar valor, unidade, meta, tendencia ou estado quando aplicavel." }, { "path": "presentationRules", "category": "appearance", "valueKind": "array", "description": "Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.", "safetyNotes": "As regras devem produzir apenas set/effect semantico. Nao use para alterar valor, executar acao, navegar ou injetar HTML/CSS.", "intentExamples": [ "se status for BLOQUEADO, usar tone danger", "se valor maior que limite, mostrar badge de revisao" ] }, { "path": "presentationRules[].when", "category": "behavior", "valueKind": "object", "description": "Guarda Json Logic avaliada contra o contexto de apresentacao do campo.", "safetyNotes": "Use Json Logic serializavel; funcoes nao sao aceitas." }, { "path": "presentationRules[].set", "category": "appearance", "valueKind": "object", "description": "Patch semantico aplicado sobre presentation quando a guarda for verdadeira.", "safetyNotes": "Somente presenter, tone, icon, label, badge, tooltip, appearance, valuePresentation e interactions seguras." }, { "path": "mask", "category": "appearance", "valueKind": "string", "description": "Máscara de input (padrão do componente).", "intentExamples": [ "máscara de CPF", "formatar telefone", "aplicar máscara de data", "pattern visual" ] }, { "path": "format", "category": "appearance", "valueKind": "string", "description": "Formato de exibição (ex: pipes).", "intentExamples": [ "formato de data dd/mm/yyyy", "formato de moeda", "exibir como porcentagem" ] }, { "path": "validators", "category": "validation", "valueKind": "object", "description": "Objeto contendo todas as regras de validação.", "safetyNotes": "Não sobrescreva este objeto inteiramente; faça merge das propriedades.", "intentExamples": [ "adicionar validações", "regras de validação", "objeto validators" ] }, { "path": "validators.required", "category": "validation", "valueKind": "boolean", "description": "Campo obrigatório.", "intentExamples": [ "tornar obrigatório", "campo mandatório", "exigir preenchimento", "remover required" ] }, { "path": "required", "category": "validation", "valueKind": "boolean", "description": "Campo obrigatório (alias rápido do validators.required).", "intentExamples": [ "campo obrigatório", "exigir preenchimento" ] }, { "path": "validators.requiredMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para required." }, { "path": "validators.email", "category": "validation", "valueKind": "boolean", "description": "Validação de formato de e-mail.", "intentExamples": [ "validar como email", "aceitar apenas emails", "formato de correio eletrônico" ] }, { "path": "validators.emailMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para validação de email." }, { "path": "validators.minLength", "category": "validation", "valueKind": "number", "description": "Comprimento mínimo do texto.", "intentExamples": [ "mínimo de 5 caracteres", "pelo menos 3 letras", "tamanho mínimo" ] }, { "path": "validators.minLengthMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para minLength." }, { "path": "validators.maxLength", "category": "validation", "valueKind": "number", "description": "Comprimento máximo do texto.", "intentExamples": [ "máximo de 100 caracteres", "limitar tamanho", "não exceder 50 letras" ] }, { "path": "validators.maxLengthMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para maxLength." }, { "path": "validators.min", "category": "validation", "valueKind": "number", "description": "Valor numérico mínimo.", "intentExamples": [ "valor mínimo 10", "não aceitar menor que 0", "piso de valor" ] }, { "path": "validators.minMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para min." }, { "path": "validators.max", "category": "validation", "valueKind": "number", "description": "Valor numérico máximo.", "intentExamples": [ "valor máximo 100", "teto de valor", "não aceitar maior que 50" ] }, { "path": "validators.maxMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para max." }, { "path": "validators.pattern", "category": "validation", "valueKind": "string", "description": "Regex para validação.", "safetyNotes": "Cuidado com ReDoS em regex complexos.", "intentExamples": [ "validar com regex", "padrão customizado", "expressão regular" ] }, { "path": "validators.patternMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para pattern." }, { "path": "validators.cpf", "category": "validation", "valueKind": "boolean", "description": "Validador de CPF (legado)." }, { "path": "validators.cnpj", "category": "validation", "valueKind": "boolean", "description": "Validador de CNPJ (legado)." }, { "path": "validators.cpfCnpj", "category": "validation", "valueKind": "boolean", "description": "Validador automatico CPF/CNPJ (legado)." }, { "path": "validators.cnpjAlpha", "category": "validation", "valueKind": "boolean", "description": "Validador de CNPJ alfanumerico (legado)." }, { "path": "validators.cpfMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CPF." }, { "path": "validators.cnpjMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CNPJ." }, { "path": "validators.cnpjAlphaMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CNPJ alfanumerico." }, { "path": "validators.url", "category": "validation", "valueKind": "boolean", "description": "Validador de URL." }, { "path": "validators.urlMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para URL." }, { "path": "validators.minWords", "category": "validation", "valueKind": "number", "description": "Mínimo de palavras.", "intentExamples": [ "mínimo de 2 palavras", "exigir nome completo (2 palavras)" ] }, { "path": "validators.requiredChecked", "category": "validation", "valueKind": "boolean", "description": "Exige checkbox marcado (ex: termos de uso).", "intentExamples": [ "obrigar marcar checkbox", "aceitar termos é obrigatório" ] }, { "path": "validators.customValidator", "category": "validation", "valueKind": "expression", "description": "Validador customizado (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.asyncValidator", "category": "validation", "valueKind": "expression", "description": "Validador async customizado (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.matchField", "category": "validation", "valueKind": "string", "description": "Campo que deve coincidir (cross-field)." }, { "path": "validators.matchFieldMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para matchField." }, { "path": "validators.uniqueValidator", "category": "validation", "valueKind": "expression", "description": "Validador de unicidade via API (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.uniqueMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para unicidade." }, { "path": "validators.conditionalValidation", "category": "validation", "valueKind": "array", "description": "Regras de validação condicional.", "safetyNotes": "Use regras declarativas com Json Logic serializável; não gere funções aqui." }, { "path": "validators.conditionalValidation[].condition", "category": "validation", "valueKind": "expression", "description": "Condicao para aplicar validadores.", "safetyNotes": "Use Json Logic canônico avaliado sobre o root `form`." }, { "path": "validators.conditionalValidation[].validators", "category": "validation", "valueKind": "object", "description": "Conjunto de validadores aplicados quando a condicao for verdadeira." }, { "path": "validators.validationTrigger", "category": "validation", "valueKind": "enum", "allowedValues": [ "change", "blur", "submit", "immediate" ], "description": "Gatilho de validação no validator." }, { "path": "validators.validationDebounce", "category": "validation", "valueKind": "number", "description": "Debounce de validação no validator (ms)." }, { "path": "validators.showInlineErrors", "category": "validation", "valueKind": "boolean", "description": "Exibe erros inline (validator)." }, { "path": "validators.errorPosition", "category": "validation", "valueKind": "enum", "allowedValues": [ "bottom", "top", "tooltip" ], "description": "Posicao do erro (validator)." }, { "path": "validationMode", "category": "validation", "valueKind": "enum", "allowedValues": [ "immediate", "blur", "submit" ], "description": "Gatilho da validação (change/blur/submit).", "intentExamples": [ "validar ao sair do campo (blur)", "validar apenas no submit", "validação em tempo real" ] }, { "path": "debounceTime", "category": "validation", "valueKind": "number", "description": "Debounce para validação em ms.", "intentExamples": [ "aguardar para validar", "debounce de 500ms", "delay na validação" ] }, { "path": "options", "category": "data", "valueKind": "array", "description": "Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).", "intentExamples": [ "adicionar opções estáticas", "lista fixa de itens", "opções do select" ], "safetyNotes": "Respeite o formato esperado pelo controlType; prefira merge/append em vez de substituir o array inteiro." }, { "path": "endpoint", "category": "data", "valueKind": "string", "description": "URL para carregar opções remotas.", "intentExamples": [ "carregar do servidor", "buscar API", "endpoint de dados", "url das opções" ] }, { "path": "valueField", "category": "data", "valueKind": "string", "description": "Nome da propriedade de valor nas opções.", "intentExamples": [ "usar \"id\" como valor", "campo de valor das opções" ] }, { "path": "displayField", "category": "data", "valueKind": "string", "description": "Nome da propriedade de texto nas opções.", "intentExamples": [ "usar \"nome\" como texto", "exibir campo \"label\"", "campo de exibição" ] }, { "path": "filterField", "category": "data", "valueKind": "string", "description": "Campo para filtragem no backend.", "intentExamples": [ "filtrar por \"categoria\"", "campo de filtro na api" ] }, { "path": "queryParams", "category": "data", "valueKind": "object", "description": "Parâmetros fixos para a query do endpoint.", "intentExamples": [ "parâmetros extras na busca", "enviar tipo=ativo na query" ] }, { "path": "cacheDuration", "category": "data", "valueKind": "number", "description": "Duração do cache de dados em ms.", "intentExamples": [ "cachear por 5 minutos", "tempo de cache", "validade dos dados" ] }, { "path": "hidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta o campo globalmente.", "critical": true, "intentExamples": [ "ocultar campo", "esconder input", "campo invisível" ] }, { "path": "visibleIn", "category": "behavior", "valueKind": "array", "allowedValues": [ "form", "filter", "table", "dialog" ], "description": "Contextos onde o campo é visível.", "intentExamples": [ "mostrar apenas no filtro", "esconder na tabela", "visível só no form" ] }, { "path": "formHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas no formulário.", "intentExamples": [ "esconder no form", "invisível na edição" ] }, { "path": "tableHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas na tabela.", "intentExamples": [ "esconder na listagem", "não mostrar na tabela" ] }, { "path": "filterHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas no filtro.", "intentExamples": [ "esconder na busca", "remover do filtro" ] }, { "path": "dependencyFields", "category": "dependency", "valueKind": "array", "description": "Campos dos quais este campo depende.", "intentExamples": [ "depende de estado", "campo dependente", "cascata com outro campo" ] }, { "path": "conditionalRequired", "category": "dependency", "valueKind": "expression", "description": "Condição Json Logic para obrigatoriedade declarativa.", "safetyNotes": "Use Json Logic serializável; não gere função nem DSL textual.", "intentExamples": [ "obrigatório se outro campo for X", "condicionalmente requerido" ] }, { "path": "conditionalDisplay", "category": "dependency", "valueKind": "expression", "description": "Condição Json Logic para visibilidade declarativa.", "safetyNotes": "Use Json Logic serializável; não gere função nem DSL textual.", "intentExamples": [ "mostrar se checkbox marcado", "visibilidade condicional" ] }, { "path": "dependencyFilterMap", "category": "dependency", "valueKind": "object", "description": "Mapeamento de filtro baseado na dependência.", "intentExamples": [ "filtrar cidade por estado", "mapear valor da dependência" ] }, { "path": "dependencyValuePath", "category": "dependency", "valueKind": "string", "description": "Caminho no valor da dependência.", "intentExamples": [ "usar propriedade aninhada da dependência", "caminho do valor dependente" ] }, { "path": "dependencyMergeStrategy", "category": "dependency", "valueKind": "enum", "allowedValues": [ "replace", "merge" ], "description": "Estratégia de merge dos dados carregados.", "intentExamples": [ "substituir opções ao carregar", "mesclar resultados" ] }, { "path": "dependencyLoadOnChange", "category": "dependency", "valueKind": "enum", "allowedValues": [ "respectLoadOn", "immediate", "manual" ], "description": "Quando recarregar dependência.", "intentExamples": [ "recarregar assim que mudar", "recarregar manualmente", "carregar imediatamente" ] }, { "path": "resetOnDependentChange", "category": "dependency", "valueKind": "boolean", "description": "Zera valor se dependência mudar.", "intentExamples": [ "limpar se o pai mudar", "resetar valor na troca da dependência" ] }, { "path": "enableDependencyCascade", "category": "dependency", "valueKind": "boolean", "description": "Habilita/desabilita cascata nativa de dependências entre campos.", "intentExamples": [ "desativar cascata nativa", "habilitar cascata", "usar connections sem cascata" ] }, { "path": "dependencyDebounceMs", "category": "dependency", "valueKind": "number", "description": "Delay para reagir à mudança de dependência.", "intentExamples": [ "esperar para recarregar dependência", "debounce da cascata" ] }, { "path": "suppressInlineErrorsOnCascade", "category": "dependency", "valueKind": "boolean", "description": "Suprime erros inline durante cascata." }, { "path": "transformDisplayValue", "category": "transform", "valueKind": "expression", "description": "Transforma valor para exibição.", "safetyNotes": "Função não serializável.", "intentExamples": [ "formatar valor visualmente", "transformar display" ] }, { "path": "transformSaveValue", "category": "transform", "valueKind": "expression", "description": "Transforma valor para salvar.", "safetyNotes": "Função não serializável.", "intentExamples": [ "formatar valor para envio", "transformar payload" ] }, { "path": "textTransformApply", "category": "transform", "valueKind": "enum", "allowedValues": [ "displayOnly", "saveOnly", "both" ], "description": "Quando aplicar transformação de texto.", "intentExamples": [ "aplicar transformação apenas no display", "transformar ao salvar e exibir" ] }, { "path": "inlineEditing", "category": "behavior", "valueKind": "boolean", "description": "Permite edição inline (tabelas).", "intentExamples": [ "permitir edição na tabela", "editar na linha" ] }, { "path": "unique", "category": "validation", "valueKind": "boolean", "description": "Valida unicidade no backend.", "intentExamples": [ "validar se é único", "não permitir duplicados" ] }, { "path": "readOnly", "category": "behavior", "valueKind": "boolean", "description": "Campo somente leitura.", "intentExamples": [ "somente leitura", "bloquear edição", "campo readonly" ] }, { "path": "disabled", "category": "behavior", "valueKind": "boolean", "description": "Campo desabilitado.", "intentExamples": [ "desabilitar campo", "campo disabled", "cinza e bloqueado" ] }, { "path": "defaultValue", "category": "data", "valueKind": "object", "description": "Valor inicial do campo.", "safetyNotes": "Aceita tipos primitivos/objetos; respeite o controlType.", "intentExamples": [ "valor padrão", "iniciar com valor X", "default value" ] }, { "path": "ariaLabel", "category": "accessibility", "valueKind": "string", "description": "Label para leitores de tela.", "intentExamples": [ "label de acessibilidade", "texto para leitor de tela" ] }, { "path": "ariaDescribedBy", "category": "accessibility", "valueKind": "string", "description": "IDs de descrição acessível.", "intentExamples": [ "descrito pelo elemento X", "associar descrição aria" ] }, { "path": "tabIndex", "category": "accessibility", "valueKind": "number", "description": "Ordem de tabulacao para teclado.", "intentExamples": [ "tabindex 0", "ordem de foco" ] }, { "path": "accessKey", "category": "accessibility", "valueKind": "string", "description": "Atalho de teclado (accessKey).", "intentExamples": [ "atalho de teclado", "tecla de acesso rapido" ] } ], "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-avatar\nSelector: pdx-material-avatar\nFriendly Name: praxis.dynamicFields.editorial.avatar.friendlyName\nDescription: praxis.dynamicFields.editorial.avatar.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, avatar, material\nInputs:\n - metadata (FieldMetadata)\n - imageSrc (string)\n - imageAlt (string)\n - initials (string)\n - name (string)\n - icon (string | SafeHtml | { name?: string; svg?: string; fontClass?: string })\n - defaultIcon (string | SafeHtml | { name?: string; svg?: string; fontClass?: string })\n - themeColor ('primary'|'secondary'|'tertiary'|'base'|'info'|'success'|'warning'|'error'|'dark'|'light'|'inverse'|'none')\n - rounded ('full'|'large'|'medium'|'small'|'none')\n - size ('xsmall'|'small'|'medium'|'large'|'xlarge'|'xxlarge'|'none')\n - fillMode ('solid'|'outline'|'none')\n - border (boolean)\n - status ('online'|'offline'|'busy'|'away'|'verified'|'none')\n - statusLabel (string)\n - badge (string | number)\n - badgeLabel (string)\n - emphasis ('none'|'ring'|'halo')\n - emphasisColor ('primary'|'secondary'|'tertiary'|'base'|'info'|'success'|'warning'|'error'|'dark'|'light'|'inverse'|'none')\n - emphasisLabel (string)\n - initialsMaxLength (number)\n - tooltip (string)\n - ariaLabel (string)\n - class (string)\n - style (NgStyle | Record)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-avatar/material-avatar.metadata.ts", "contentHash": "352a6872ee664e117e234a3bdb3f796c278e6e2338a0b68d7e071d0577390898", "sourceKind": "component_definition", "sourceId": "pdx-material-avatar", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "capabilities", "content": "Schema Capabilities:\n - Path: id\n Category: identity\n Kind: string\n Description: Identificador unico da instancia do componente.\n - Path: version\n Category: identity\n Kind: string\n Description: Versao do schema de metadata (migracao).\n - Path: context\n Category: identity\n Kind: enum\n Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n - Path: createdAt\n Category: misc\n Kind: string\n Description: Timestamp de criacao (ISO).\n - Path: updatedAt\n Category: misc\n Kind: string\n Description: Timestamp de atualizacao (ISO).\n - Path: tags\n Category: identity\n Kind: array\n Description: Tags para categorizacao e busca.\n - Path: cssClass\n Category: appearance\n Kind: string\n Description: Classe CSS aplicada ao host do componente.\n - Path: style\n Category: appearance\n Kind: object\n Description: Estilos inline (objeto CSS).\n - Path: dataAttributes\n Category: data\n Kind: object\n Description: Data attributes para teste/analytics.\n - Path: name\n Category: identity\n Kind: string\n Description: Identificador único do campo. Essencial para binding.\n - Path: label\n Category: identity\n Kind: string\n Description: Rótulo principal exibido para o usuário.\n - Path: placeholder\n Category: identity\n Kind: string\n Description: Texto temporário exibido quando vazio.\n - Path: hint\n Category: identity\n Kind: string\n Description: Texto de ajuda exibido abaixo do campo.\n - Path: helpText\n Category: identity\n Kind: string\n Description: Texto semântico de ajuda publicado pelo schema/DTO.\n - Path: tooltip\n Category: identity\n Kind: string\n Description: Texto exibido ao passar o mouse.\n - Path: tooltipOnHover\n Category: identity\n Kind: boolean\n Description: Habilita apresentação do tooltip no hover quando suportado pelo renderer.\n - Path: description\n Category: identity\n Kind: string\n Description: Descrição detalhada (usada em documentação ou helps extensos).\n - Path: selectionMode\n Category: behavior\n Kind: enum\n Description: Semântica de seleção explícita para controles de escolha.\n - Path: variant\n Category: appearance\n Kind: string\n Description: Variante visual/semântica do controle.\n - Path: density\n Category: appearance\n Kind: enum\n Description: Densidade visual do shell do controle.\n - Path: links\n Category: identity\n Kind: array\n Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n - Path: group\n Category: identity\n Kind: string\n Description: Agrupador lógico do campo.\n - Path: order\n Category: layout\n Kind: number\n Description: Ordem de exibição do campo.\n - Path: width\n Category: layout\n Kind: string\n Description: Largura do campo (ex: 50%, 100px).\n - Path: isFlex\n Category: layout\n Kind: boolean\n Description: Se true, usa flex-grow para preencher espaço.\n - Path: controlType\n Category: behavior\n Kind: enum\n Description: Tipo do componente de UI (input, select, datepicker, etc).\n - Path: dataType\n Category: data\n Kind: enum\n Description: Tipo de dado do campo (text, number, date, etc).\n - Path: source\n Category: data\n Kind: enum\n Description: Origem semântica do campo. Use local para campos do host que não vêm do schema backend.\n - Path: transient\n Category: data\n Kind: boolean\n Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n - Path: submitPolicy\n Category: behavior\n Kind: enum\n Description: Política de submit para sobrescrever o padrão de campos locais/transient.\n - Path: materialDesign.appearance\n Category: appearance\n Kind: enum\n Description: Aparência do campo Material (fill/outline).\n - Path: materialDesign.color\n Category: appearance\n Kind: enum\n Description: Tema de cor Material (primary/accent/warn).\n - Path: materialDesign.floatLabel\n Category: appearance\n Kind: enum\n Description: Comportamento do rótulo flutuante.\n - Path: materialDesign.subscriptSizing\n Category: appearance\n Kind: enum\n Description: Estratégia de sizing do subscript (erros/hints).\n - Path: materialDesign.hideRequiredMarker\n Category: appearance\n Kind: boolean\n Description: Oculta o asterisco de campo obrigatório.\n - Path: materialDesign.density\n Category: appearance\n Kind: enum\n Description: Densidade do campo Material.\n - Path: materialDesign.disableRipple\n Category: appearance\n Kind: boolean\n Description: Desativa ripple/ondulação em componentes Material.\n - Path: materialDesign.customPalette\n Category: appearance\n Kind: object\n Description: Override de paleta (primary/accent/warn).\n - Path: materialDesign.animations\n Category: appearance\n Kind: object\n Description: Configuração de animações (disable, duration, easing).\n - Path: prefixIcon\n Category: appearance\n Kind: string\n Description: Ícone exibido antes do valor.\n - Path: suffixIcon\n Category: appearance\n Kind: string\n Description: Ícone exibido depois do valor.\n - Path: iconPosition\n Category: appearance\n Kind: enum\n Description: Posição preferencial do ícone principal.\n - Path: iconSize\n Category: appearance\n Kind: enum\n Description: Tamanho do ícone.\n - Path: iconColor\n Category: appearance\n Kind: string\n Description: Cor semântica ou token de cor aplicado ao ícone principal.\n - Path: iconClass\n Category: appearance\n Kind: string\n Description: Classe CSS controlada pelo host para o ícone principal.\n - Path: iconStyle\n Category: appearance\n Kind: string\n Description: Estilo visual semântico do ícone quando o renderer suportar variações.\n - Path: iconFontSize\n Category: appearance\n Kind: string\n Description: Tamanho tipográfico do ícone principal.\n - Path: valuePresentation\n Category: appearance\n Kind: object\n Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n - Path: presentation\n Category: appearance\n Kind: object\n Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n - Path: presentation.presenter\n Category: appearance\n Kind: enum\n Description: Tipo semantico de renderizacao em modo apresentacao.\n - Path: presentation.tone\n Category: appearance\n Kind: enum\n Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n - Path: presentation.appearance\n Category: appearance\n Kind: enum\n Description: Nivel de enfase visual do apresentador.\n - Path: presentation.icon\n Category: appearance\n Kind: string\n Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n - Path: presentation.label\n Category: identity\n Kind: string\n Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n - Path: presentation.badge\n Category: appearance\n Kind: string\n Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n - Path: presentation.valuePresentation\n Category: appearance\n Kind: object\n Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n - Path: presentation.visualization\n Category: appearance\n Kind: object\n Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n - Path: presentation.visualization.kind\n Category: appearance\n Kind: enum\n Description: Tipo semantico da micro visualizacao de apresentacao.\n - Path: presentation.visualization.surface\n Category: layout\n Kind: enum\n Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n - Path: presentation.visualization.size\n Category: layout\n Kind: enum\n Description: Tamanho semantico da micro visualizacao.\n - Path: presentation.visualization.fallbackText\n Category: accessibility\n Kind: string\n Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n - Path: presentationRules\n Category: appearance\n Kind: array\n Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n - Path: presentationRules[].when\n Category: behavior\n Kind: object\n Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n - Path: presentationRules[].set\n Category: appearance\n Kind: object\n Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\n - Path: mask\n Category: appearance\n Kind: string\n Description: Máscara de input (padrão do componente).\n - Path: format\n Category: appearance\n Kind: string\n Description: Formato de exibição (ex: pipes).\n - Path: validators\n Category: validation\n Kind: object\n Description: Objeto contendo todas as regras de validação.\n - Path: validators.required\n Category: validation\n Kind: boolean\n Description: Campo obrigatório.\n - Path: required\n Category: validation\n Kind: boolean\n Description: Campo obrigatório (alias rápido do validators.required).\n - Path: validators.requiredMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para required.\n - Path: validators.email\n Category: validation\n Kind: boolean\n Description: Validação de formato de e-mail.\n - Path: validators.emailMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para validação de email.\n - Path: validators.minLength\n Category: validation\n Kind: number\n Description: Comprimento mínimo do texto.\n - Path: validators.minLengthMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para minLength.\n - Path: validators.maxLength\n Category: validation\n Kind: number\n Description: Comprimento máximo do texto.\n - Path: validators.maxLengthMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para maxLength.\n - Path: validators.min\n Category: validation\n Kind: number\n Description: Valor numérico mínimo.\n - Path: validators.minMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para min.\n - Path: validators.max\n Category: validation\n Kind: number\n Description: Valor numérico máximo.\n - Path: validators.maxMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para max.\n - Path: validators.pattern\n Category: validation\n Kind: string\n Description: Regex para validação.\n - Path: validators.patternMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para pattern.\n - Path: validators.cpf\n Category: validation\n Kind: boolean\n Description: Validador de CPF (legado).\n - Path: validators.cnpj\n Category: validation\n Kind: boolean\n Description: Validador de CNPJ (legado).\n - Path: validators.cpfCnpj\n Category: validation\n Kind: boolean\n Description: Validador automatico CPF/CNPJ (legado).\n - Path: validators.cnpjAlpha\n Category: validation\n Kind: boolean\n Description: Validador de CNPJ alfanumerico (legado).\n - Path: validators.cpfMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CPF.\n - Path: validators.cnpjMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CNPJ.\n - Path: validators.cnpjAlphaMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CNPJ alfanumerico.\n - Path: validators.url\n Category: validation\n Kind: boolean\n Description: Validador de URL.\n - Path: validators.urlMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para URL.\n - Path: validators.minWords\n Category: validation\n Kind: number\n Description: Mínimo de palavras.\n - Path: validators.requiredChecked\n Category: validation\n Kind: boolean\n Description: Exige checkbox marcado (ex: termos de uso).\n - Path: validators.customValidator\n Category: validation\n Kind: expression\n Description: Validador customizado (função).\n - Path: validators.asyncValidator\n Category: validation\n Kind: expression\n Description: Validador async customizado (função).\n - Path: validators.matchField\n Category: validation\n Kind: string\n Description: Campo que deve coincidir (cross-field).\n - Path: validators.matchFieldMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para matchField.\n - Path: validators.uniqueValidator\n Category: validation\n Kind: expression\n Description: Validador de unicidade via API (função).\n - Path: validators.uniqueMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para unicidade.\n - Path: validators.conditionalValidation\n Category: validation\n Kind: array\n Description: Regras de validação condicional.\n - Path: validators.conditionalValidation[].condition\n Category: validation\n Kind: expression\n Description: Condicao para aplicar validadores.\n - Path: validators.conditionalValidation[].validators\n Category: validation\n Kind: object\n Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n - Path: validators.validationTrigger\n Category: validation\n Kind: enum\n Description: Gatilho de validação no validator.\n - Path: validators.validationDebounce\n Category: validation\n Kind: number\n Description: Debounce de validação no validator (ms).\n - Path: validators.showInlineErrors\n Category: validation\n Kind: boolean\n Description: Exibe erros inline (validator).\n - Path: validators.errorPosition\n Category: validation\n Kind: enum\n Description: Posicao do erro (validator).\n - Path: validationMode\n Category: validation\n Kind: enum\n Description: Gatilho da validação (change/blur/submit).\n - Path: debounceTime\n Category: validation\n Kind: number\n Description: Debounce para validação em ms.\n - Path: options\n Category: data\n Kind: array\n Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n - Path: endpoint\n Category: data\n Kind: string\n Description: URL para carregar opções remotas.\n - Path: valueField\n Category: data\n Kind: string\n Description: Nome da propriedade de valor nas opções.\n - Path: displayField\n Category: data\n Kind: string\n Description: Nome da propriedade de texto nas opções.\n - Path: filterField\n Category: data\n Kind: string\n Description: Campo para filtragem no backend.\n - Path: queryParams\n Category: data\n Kind: object\n Description: Parâmetros fixos para a query do endpoint.\n - Path: cacheDuration\n Category: data\n Kind: number\n Description: Duração do cache de dados em ms.\n - Path: hidden\n Category: behavior\n Kind: boolean\n Description: Oculta o campo globalmente.\n - Path: visibleIn\n Category: behavior\n Kind: array\n Description: Contextos onde o campo é visível.\n - Path: formHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas no formulário.\n - Path: tableHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas na tabela.\n - Path: filterHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas no filtro.\n - Path: dependencyFields\n Category: dependency\n Kind: array\n Description: Campos dos quais este campo depende.\n - Path: conditionalRequired\n Category: dependency\n Kind: expression\n Description: Condição Json Logic para obrigatoriedade declarativa.\n - Path: conditionalDisplay\n Category: dependency\n Kind: expression\n Description: Condição Json Logic para visibilidade declarativa.\n - Path: dependencyFilterMap\n Category: dependency\n Kind: object\n Description: Mapeamento de filtro baseado na dependência.\n - Path: dependencyValuePath\n Category: dependency\n Kind: string\n Description: Caminho no valor da dependência.\n - Path: dependencyMergeStrategy\n Category: dependency\n Kind: enum\n Description: Estratégia de merge dos dados carregados.\n - Path: dependencyLoadOnChange\n Category: dependency\n Kind: enum\n Description: Quando recarregar dependência.\n - Path: resetOnDependentChange\n Category: dependency\n Kind: boolean\n Description: Zera valor se dependência mudar.\n - Path: enableDependencyCascade\n Category: dependency\n Kind: boolean\n Description: Habilita/desabilita cascata nativa de dependências entre campos.\n - Path: dependencyDebounceMs\n Category: dependency\n Kind: number\n Description: Delay para reagir à mudança de dependência.\n - Path: suppressInlineErrorsOnCascade\n Category: dependency\n Kind: boolean\n Description: Suprime erros inline durante cascata.\n - Path: transformDisplayValue\n Category: transform\n Kind: expression\n Description: Transforma valor para exibição.\n - Path: transformSaveValue\n Category: transform\n Kind: expression\n Description: Transforma valor para salvar.\n - Path: textTransformApply\n Category: transform\n Kind: enum\n Description: Quando aplicar transformação de texto.\n - Path: inlineEditing\n Category: behavior\n Kind: boolean\n Description: Permite edição inline (tabelas).\n - Path: unique\n Category: validation\n Kind: boolean\n Description: Valida unicidade no backend.\n - Path: readOnly\n Category: behavior\n Kind: boolean\n Description: Campo somente leitura.\n - Path: disabled\n Category: behavior\n Kind: boolean\n Description: Campo desabilitado.\n - Path: defaultValue\n Category: data\n Kind: object\n Description: Valor inicial do campo.\n - Path: ariaLabel\n Category: accessibility\n Kind: string\n Description: Label para leitores de tela.\n - Path: ariaDescribedBy\n Category: accessibility\n Kind: string\n Description: IDs de descrição acessível.\n - Path: tabIndex\n Category: accessibility\n Kind: number\n Description: Ordem de tabulacao para teclado.\n - Path: accessKey\n Category: accessibility\n Kind: string\n Description: Atalho de teclado (accessKey).\n", "sourcePointer": "praxis-ui-angular/projects/praxis-core/src/lib/ai/field-metadata-ai-capabilities.ts", "contentHash": "466e427814fe510e5b0108e418a13f828b5a363d3da46bf9b69be588c7088ce2", "sourceKind": "component_definition", "sourceId": "pdx-material-avatar", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"avatar\",\n \"title\": \"Avatar controls\",\n \"description\": \"Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-avatar\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.avatar.configure\",\n \"title\": \"Configure avatar field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"extra\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"imageSrc\": {\n \"type\": \"string\"\n },\n \"imageAlt\": {\n \"type\": \"string\"\n },\n \"initials\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"defaultIcon\": {\n \"type\": \"string\"\n },\n \"themeColor\": {\n \"enum\": [\n \"primary\",\n \"secondary\",\n \"tertiary\",\n \"base\",\n \"info\",\n \"success\",\n \"warning\",\n \"error\",\n \"dark\",\n \"light\",\n \"inverse\",\n \"none\"\n ]\n },\n \"rounded\": {\n \"enum\": [\n \"full\",\n \"large\",\n \"medium\",\n \"small\",\n \"none\"\n ]\n },\n \"size\": {\n \"enum\": [\n \"xsmall\",\n \"small\",\n \"medium\",\n \"large\",\n \"xlarge\",\n \"xxlarge\",\n \"none\"\n ]\n },\n \"fillMode\": {\n \"enum\": [\n \"solid\",\n \"outline\",\n \"none\"\n ]\n },\n \"border\": {\n \"type\": \"boolean\"\n },\n \"status\": {\n \"enum\": [\n \"online\",\n \"offline\",\n \"busy\",\n \"away\",\n \"verified\",\n \"none\"\n ]\n },\n \"statusLabel\": {\n \"type\": \"string\"\n },\n \"badge\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"number\"\n }\n ]\n },\n \"badgeLabel\": {\n \"type\": \"string\"\n },\n \"emphasis\": {\n \"enum\": [\n \"none\",\n \"ring\",\n \"halo\"\n ]\n },\n \"emphasisColor\": {\n \"enum\": [\n \"primary\",\n \"secondary\",\n \"tertiary\",\n \"base\",\n \"info\",\n \"success\",\n \"warning\",\n \"error\",\n \"dark\",\n \"light\",\n \"inverse\",\n \"none\"\n ]\n },\n \"emphasisLabel\": {\n \"type\": \"string\"\n },\n \"initialsMaxLength\": {\n \"type\": \"number\",\n \"minimum\": 1,\n \"maximum\": 4\n },\n \"tooltip\": {\n \"type\": \"string\"\n },\n \"ariaLabel\": {\n \"type\": \"string\"\n },\n \"groupLabel\": {\n \"type\": \"string\"\n },\n \"groupMaxVisible\": {\n \"type\": \"number\",\n \"minimum\": 1,\n \"maximum\": 12\n },\n \"groupOverflowLabel\": {\n \"type\": \"string\"\n },\n \"groupOverlap\": {\n \"type\": \"number\",\n \"minimum\": 0,\n \"maximum\": 32\n },\n \"groupItems\": {\n \"type\": \"array\",\n \"minItems\": 1,\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"imageSrc\": {\n \"type\": \"string\"\n },\n \"imageAlt\": {\n \"type\": \"string\"\n },\n \"initials\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"defaultIcon\": {\n \"type\": \"string\"\n },\n \"themeColor\": {\n \"enum\": [\n \"primary\",\n \"secondary\",\n \"tertiary\",\n \"base\",\n \"info\",\n \"success\",\n \"warning\",\n \"error\",\n \"dark\",\n \"light\",\n \"inverse\",\n \"none\"\n ]\n },\n \"rounded\": {\n \"enum\": [\n \"full\",\n \"large\",\n \"medium\",\n \"small\",\n \"none\"\n ]\n },\n \"fillMode\": {\n \"enum\": [\n \"solid\",\n \"outline\",\n \"none\"\n ]\n },\n \"status\": {\n \"enum\": [\n \"online\",\n \"offline\",\n \"busy\",\n \"away\",\n \"verified\",\n \"none\"\n ]\n },\n \"statusLabel\": {\n \"type\": \"string\"\n },\n \"emphasis\": {\n \"enum\": [\n \"none\",\n \"ring\",\n \"halo\"\n ]\n },\n \"emphasisColor\": {\n \"enum\": [\n \"primary\",\n \"secondary\",\n \"tertiary\",\n \"base\",\n \"info\",\n \"success\",\n \"warning\",\n \"error\",\n \"dark\",\n \"light\",\n \"inverse\",\n \"none\"\n ]\n },\n \"emphasisLabel\": {\n \"type\": \"string\"\n },\n \"tooltip\": {\n \"type\": \"string\"\n },\n \"ariaLabel\": {\n \"type\": \"string\"\n }\n },\n \"additionalProperties\": false\n }\n }\n },\n \"additionalProperties\": false\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"avatar-presentation-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.extra.imageSrc\",\n \"fieldMetadata.extra.imageAlt\",\n \"fieldMetadata.extra.initials\",\n \"fieldMetadata.extra.name\",\n \"fieldMetadata.extra.icon\",\n \"fieldMetadata.extra.defaultIcon\",\n \"fieldMetadata.extra.themeColor\",\n \"fieldMetadata.extra.rounded\",\n \"fieldMetadata.extra.size\",\n \"fieldMetadata.extra.fillMode\",\n \"fieldMetadata.extra.border\",\n \"fieldMetadata.extra.status\",\n \"fieldMetadata.extra.statusLabel\",\n \"fieldMetadata.extra.badge\",\n \"fieldMetadata.extra.badgeLabel\",\n \"fieldMetadata.extra.emphasis\",\n \"fieldMetadata.extra.emphasisColor\",\n \"fieldMetadata.extra.emphasisLabel\",\n \"fieldMetadata.extra.initialsMaxLength\",\n \"fieldMetadata.extra.tooltip\",\n \"fieldMetadata.extra.ariaLabel\",\n \"fieldMetadata.extra.groupLabel\",\n \"fieldMetadata.extra.groupMaxVisible\",\n \"fieldMetadata.extra.groupOverflowLabel\",\n \"fieldMetadata.extra.groupOverlap\",\n \"fieldMetadata.extra.groupItems\"\n ],\n \"submissionImpact\": \"visual-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"avatar-presentation-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP023\",\n \"description\": \"Avatar controls must keep display metadata separate from submitted domain value semantics.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-avatar-fields\",\n \"request\": \"Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.\",\n \"operationId\": \"field.avatar.configure\",\n \"params\": {\n \"extra\": {\n \"initials\": \"AL\",\n \"name\": \"Ada Lovelace\",\n \"defaultIcon\": \"person\",\n \"size\": \"large\",\n \"themeColor\": \"tertiary\",\n \"status\": \"verified\",\n \"statusLabel\": \"Verified profile\",\n \"badge\": 3,\n \"badgeLabel\": \"3 pending items\",\n \"emphasis\": \"ring\",\n \"emphasisColor\": \"success\",\n \"emphasisLabel\": \"Selected reviewer\",\n \"ariaLabel\": \"Avatar de Ada Lovelace\"\n }\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "02481cd61c32028dad8c590217a477471fc7661a09da11980fa13cfb33e81e4d", "sourceKind": "component_definition", "sourceId": "pdx-material-avatar", "corpusVersion": "1.0.0" }, { "chunkIndex": 3, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-avatar | controlType: avatar\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-avatar\",\n \"tags\": [\n \"dynamic-fields\",\n \"action\"\n ],\n \"useWhen\": \"criar campo avatar\",\n \"examplePrompts\": [\n \"crie um campo avatar\",\n \"adicione um avatar ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_avatar\",\n \"label\": \"Example avatar\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"avatar\",\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"extra\": {\n \"imageSrc\": \"https://picsum.photos/200\",\n \"imageAlt\": \"Avatar\",\n \"initials\": \"AB\",\n \"name\": \"Ana Brasil\",\n \"icon\": \"mi:person\",\n \"defaultIcon\": \"mi:person_outline\",\n \"themeColor\": \"primary\",\n \"rounded\": \"full\",\n \"size\": \"medium\",\n \"fillMode\": \"solid\",\n \"border\": false,\n \"tooltip\": \"Avatar\",\n \"ariaLabel\": \"Avatar do usuario\"\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-avatar.json", "contentHash": "74668d15dec4337063c5c317488be572479578ecb9a50b1a566262fe50f7a555", "sourceKind": "component_definition", "sourceId": "pdx-material-avatar", "corpusVersion": "1.0.0" } ] }, "pdx-material-button": { "id": "pdx-material-button", "description": "Botão configurável com variantes, loading e ações.", "inputs": [ { "name": "metadata", "type": "MaterialButtonMetadata", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-button", "friendlyName": "Botão (Material)", "icon": "smart_button", "tags": [ "widget", "button", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-button/material-button.metadata.ts", "exportName": "PDX_MATERIAL_BUTTON_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-button\nSelector: pdx-material-button\nFriendly Name: Botão (Material)\nDescription: Botão configurável com variantes, loading e ações.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, button, material\nInputs:\n - metadata (MaterialButtonMetadata)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-button/material-button.metadata.ts", "contentHash": "915be8a24d155a0e6abbc81210d958b25cf6b408d4359dbf6191d002dac47452", "sourceKind": "component_definition", "sourceId": "pdx-material-button", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"display-action\",\n \"title\": \"Display and action controls\",\n \"description\": \"Profile for non-data or action-like field controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-button\",\n \"pdx-preload-status\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Display/action metadata paths such as label, icon, action id, loading state and presentation mode.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.displayAction.configure\",\n \"title\": \"Configure display/action field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"actionId\": {\n \"type\": \"string\"\n },\n \"presentationOnly\": {\n \"type\": \"boolean\"\n },\n \"loadingStatePath\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"display-action-contract-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.label\",\n \"fieldMetadata.icon\",\n \"fieldMetadata.actionId\",\n \"fieldMetadata.presentationOnly\",\n \"fieldMetadata.loadingStatePath\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"display-action-contract-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP018\",\n \"description\": \"Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-action-button\",\n \"request\": \"Configure a button field to trigger the refresh action.\",\n \"operationId\": \"field.displayAction.configure\",\n \"params\": {\n \"label\": \"Refresh\",\n \"icon\": \"refresh\",\n \"actionId\": \"refresh\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "573fbd371267ad9aa74be8f69f9957c57b072396f3e438bdf61a4d7250cd1928", "sourceKind": "component_definition", "sourceId": "pdx-material-button", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-button | controlType: button\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-button\",\n \"tags\": [\n \"dynamic-fields\",\n \"action\"\n ],\n \"useWhen\": \"criar campo button\",\n \"examplePrompts\": [\n \"crie um campo button\",\n \"adicione um button ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_button\",\n \"label\": \"Example button\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"button\",\n \"materialDesign\": {\n \"color\": \"primary\"\n },\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"disabled\": true,\n \"ariaLabel\": \"example\",\n \"icon\": \"example\",\n \"variant\": \"raised\",\n \"loading\": true,\n \"action\": \"example\",\n \"disableRipple\": true\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-button.json", "contentHash": "34ff28c90d509e5bf9a8b05da15223c480f76f1cb5a72ce8e407eef6bb174668", "sourceKind": "component_definition", "sourceId": "pdx-material-button", "corpusVersion": "1.0.0" } ] }, "pdx-material-button-toggle": { "id": "pdx-material-button-toggle", "description": "Grupo de botões toggle para seleção única ou múltipla.", "inputs": [ { "name": "metadata", "type": "MaterialButtonToggleMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-button-toggle", "friendlyName": "Button Toggle (Material)", "icon": "toggle_on", "tags": [ "widget", "field", "toggle", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-button-toggle/material-button-toggle.metadata.ts", "exportName": "PDX_MATERIAL_BUTTON_TOGGLE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-button-toggle\nSelector: pdx-material-button-toggle\nFriendly Name: Button Toggle (Material)\nDescription: Grupo de botões toggle para seleção única ou múltipla.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, toggle, material\nInputs:\n - metadata (MaterialButtonToggleMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-button-toggle/material-button-toggle.metadata.ts", "contentHash": "0dc1d0b211c3acd617de023ecf7ed5202f4bad4b866ce98744d031be4549f1ad", "sourceKind": "component_definition", "sourceId": "pdx-material-button-toggle", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-material-button-toggle", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-button-toggle | controlType: buttonToggle\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-button-toggle\",\n \"tags\": [\n \"dynamic-fields\",\n \"action\"\n ],\n \"useWhen\": \"criar campo buttonToggle\",\n \"examplePrompts\": [\n \"crie um campo buttonToggle\",\n \"adicione um buttonToggle ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_buttonToggle\",\n \"label\": \"Example buttonToggle\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"buttonToggle\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-button-toggle.json", "contentHash": "c2a47f3aa2728997ba1545e0dd74bd329c733f0baf79a798fd15cd0edb7e48a2", "sourceKind": "component_definition", "sourceId": "pdx-material-button-toggle", "corpusVersion": "1.0.0" } ] }, "pdx-material-checkbox-group": { "id": "pdx-material-checkbox-group", "description": "praxis.dynamicFields.editorial.checkboxGroup.description", "inputs": [ { "name": "metadata", "type": "MaterialCheckboxMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-checkbox-group", "friendlyName": "praxis.dynamicFields.editorial.checkboxGroup.friendlyName", "icon": "check_box", "tags": [ "widget", "field", "checkbox", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-checkbox-group/material-checkbox-group.metadata.ts", "exportName": "PDX_MATERIAL_CHECKBOX_GROUP_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-checkbox-group\nSelector: pdx-material-checkbox-group\nFriendly Name: praxis.dynamicFields.editorial.checkboxGroup.friendlyName\nDescription: praxis.dynamicFields.editorial.checkboxGroup.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, checkbox, material\nInputs:\n - metadata (MaterialCheckboxMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-checkbox-group/material-checkbox-group.metadata.ts", "contentHash": "47b3a1a051c66b8727fd7d013eb8742c00f6afa491c5778fe4f13a2a31ae37e2", "sourceKind": "component_definition", "sourceId": "pdx-material-checkbox-group", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-material-checkbox-group", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-checkbox-group | controlType: checkbox\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-checkbox-group\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo checkbox\",\n \"examplePrompts\": [\n \"crie um campo checkbox\",\n \"adicione um checkbox ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_checkbox\",\n \"label\": \"Example checkbox\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"checkbox\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-checkbox-group.json", "contentHash": "2a966b534978a30b49051951b402a80813c02e0930caae0e82090c35d2cb073f", "sourceKind": "component_definition", "sourceId": "pdx-material-checkbox-group", "corpusVersion": "1.0.0" } ] }, "pdx-material-chips": { "id": "pdx-material-chips", "description": "Campo de chips com adição/remoção de itens e autocomplete.", "inputs": [ { "name": "metadata", "type": "MaterialChipsMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-chips", "friendlyName": "Chips (Material)", "icon": "sell", "tags": [ "widget", "field", "chips", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-chips/material-chips.metadata.ts", "exportName": "PDX_MATERIAL_CHIPS_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-chips\nSelector: pdx-material-chips\nFriendly Name: Chips (Material)\nDescription: Campo de chips com adição/remoção de itens e autocomplete.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, chips, material\nInputs:\n - metadata (MaterialChipsMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-chips/material-chips.metadata.ts", "contentHash": "80f5a4b5f76f239bcede04d6fed23ecf46c362bbd1c72f62e33fc0ba6c9371c6", "sourceKind": "component_definition", "sourceId": "pdx-material-chips", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-material-chips", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-chips | controlType: chipInput | aliases: chipList\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-chips\",\n \"tags\": [\n \"dynamic-fields\",\n \"base\"\n ],\n \"useWhen\": \"criar campo chipInput\",\n \"examplePrompts\": [\n \"crie um campo chipInput\",\n \"adicione um chipInput ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_chipInput\",\n \"label\": \"Example chipInput\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"chipInput\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-chips.json", "contentHash": "4bb1b721830dc30c0e1ed6a6396085dbb46a89e3211699c0b719d5902f748fab", "sourceKind": "component_definition", "sourceId": "pdx-material-chips", "corpusVersion": "1.0.0" } ] }, "pdx-material-colorpicker": { "id": "pdx-material-colorpicker", "description": "Seletor de cor com suporte a presets e input.", "inputs": [ { "name": "metadata", "type": "MaterialColorPickerMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-colorpicker", "friendlyName": "Colorpicker (Material)", "icon": "palette", "tags": [ "widget", "field", "color", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-colorpicker/material-colorpicker.metadata.ts", "exportName": "PDX_MATERIAL_COLORPICKER_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-colorpicker\nSelector: pdx-material-colorpicker\nFriendly Name: Colorpicker (Material)\nDescription: Seletor de cor com suporte a presets e input.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, color, material\nInputs:\n - metadata (MaterialColorPickerMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-colorpicker/material-colorpicker.metadata.ts", "contentHash": "039ca44ce3076a9956ad6d149c5c94bfe6ca8afb6b7b114a722bc800506cc2bf", "sourceKind": "component_definition", "sourceId": "pdx-material-colorpicker", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"color\",\n \"title\": \"Color controls\",\n \"description\": \"Profile for color input and picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-color-input\",\n \"pdx-color-picker\",\n \"pdx-material-colorpicker\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Color metadata paths such as format, alpha support and palette presets.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.color.configure\",\n \"title\": \"Configure color field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"format\": {\n \"enum\": [\n \"hex\",\n \"rgb\",\n \"rgba\"\n ]\n },\n \"allowAlpha\": {\n \"type\": \"boolean\"\n },\n \"palette\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"color-format-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.format\",\n \"fieldMetadata.allowAlpha\",\n \"fieldMetadata.palette\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"color-format-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP016\",\n \"description\": \"Color values and palette entries must match the configured color format.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-color-hex-palette\",\n \"request\": \"Use hex colors and offer brand palette presets.\",\n \"operationId\": \"field.color.configure\",\n \"params\": {\n \"format\": \"hex\",\n \"allowAlpha\": false,\n \"palette\": [\n \"#0057B8\",\n \"#00A676\"\n ]\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "7c84a30ae96bf1ab1ec0733458cc04a7144bf3fe81f504227a4deb942a0fec2e", "sourceKind": "component_definition", "sourceId": "pdx-material-colorpicker", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-colorpicker | controlType: colorPicker\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-colorpicker\",\n \"tags\": [\n \"dynamic-fields\",\n \"color\"\n ],\n \"useWhen\": \"criar campo material colorpicker\",\n \"examplePrompts\": [\n \"crie um campo material colorpicker\",\n \"adicione um material colorpicker ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_material_colorpicker\",\n \"label\": \"Example material colorpicker\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"colorPicker\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"format\": \"hex\",\n \"showAlpha\": true,\n \"presetColors\": [\n \"#ff0000\",\n \"#00ff00\"\n ],\n \"allowCustomColors\": true,\n \"variant\": \"default\",\n \"showInput\": true,\n \"showPreview\": true,\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"views\": [\n \"gradient\"\n ],\n \"activeView\": \"gradient\",\n \"preview\": true,\n \"clearButton\": true,\n \"actionsLayout\": \"start\",\n \"adaptiveMode\": true,\n \"adaptiveTitle\": \"example\",\n \"adaptiveSubtitle\": \"example\",\n \"popupSettings\": {\n \"example\": true\n },\n \"gradientSettings\": {\n \"example\": true\n },\n \"paletteSettings\": {\n \"example\": true\n },\n \"fillMode\": \"solid\",\n \"rounded\": \"none\",\n \"size\": \"small\",\n \"icon\": \"example\",\n \"iconClass\": \"example\",\n \"svgIcon\": \"example\",\n \"tabindex\": 1\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-colorpicker.json", "contentHash": "1e529e184da07e4280094ef35963a8ee9f683e7e6a01301e93b35d7d4a69c7d6", "sourceKind": "component_definition", "sourceId": "pdx-material-colorpicker", "corpusVersion": "1.0.0" } ] }, "pdx-material-cpf-cnpj-input": { "id": "pdx-material-cpf-cnpj-input", "description": "Campo para documentos nacionais com máscara e validação.", "inputs": [ { "name": "metadata", "type": "MaterialCpfCnpjMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-cpf-cnpj-input", "friendlyName": "CPF/CNPJ (Material)", "icon": "badge", "tags": [ "widget", "field", "document", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-cpf-cnpj-input/material-cpf-cnpj-input.metadata.ts", "exportName": "PDX_MATERIAL_CPF_CNPJ_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-cpf-cnpj-input\nSelector: pdx-material-cpf-cnpj-input\nFriendly Name: CPF/CNPJ (Material)\nDescription: Campo para documentos nacionais com máscara e validação.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, document, material\nInputs:\n - metadata (MaterialCpfCnpjMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-cpf-cnpj-input/material-cpf-cnpj-input.metadata.ts", "contentHash": "5f31c0a34868066aa3f33002bc697f5029c95a57f65709e90e69c93a124686c2", "sourceKind": "component_definition", "sourceId": "pdx-material-cpf-cnpj-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"regional-document\",\n \"title\": \"Regional document controls\",\n \"description\": \"Profile for Brazilian CPF/CNPJ document input controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-cpf-cnpj-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Regional document metadata paths such as document type, mask and validation mode.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.regionalDocument.configure\",\n \"title\": \"Configure regional document field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"documentType\": {\n \"enum\": [\n \"cpf\",\n \"cnpj\",\n \"cpfOrCnpj\"\n ]\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"validateChecksum\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"regional-document-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.documentType\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.validateChecksum\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"regional-document-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP017\",\n \"description\": \"Regional document controls must preserve document type, mask and checksum validation semantics.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-cpf-cnpj-document\",\n \"request\": \"Accept CPF or CNPJ and validate the document checksum.\",\n \"operationId\": \"field.regionalDocument.configure\",\n \"params\": {\n \"documentType\": \"cpfOrCnpj\",\n \"validateChecksum\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "11547fccc8636f7dcade00393c2363eb01b6bdea7f2d0a6b5eee6caf760672d8", "sourceKind": "component_definition", "sourceId": "pdx-material-cpf-cnpj-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-cpf-cnpj-input | controlType: cpfCnpjInput\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-cpf-cnpj-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"brazil\"\n ],\n \"useWhen\": \"criar campo cpfCnpjInput\",\n \"examplePrompts\": [\n \"crie um campo cpfCnpjInput\",\n \"adicione um cpfCnpjInput ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_cpfCnpjInput\",\n \"label\": \"Example cpfCnpjInput\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"cpfCnpjInput\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"cpf\": true,\n \"cnpj\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"text\",\n \"maskType\": \"cpf\",\n \"unmaskOnSubmit\": true\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-cpf-cnpj-input.json", "contentHash": "495ef7b725ab8ca2b83faa456653fd877238b9cdb06ee5f09adccf5ba46afffa", "sourceKind": "component_definition", "sourceId": "pdx-material-cpf-cnpj-input", "corpusVersion": "1.0.0" } ] }, "pdx-material-currency": { "id": "pdx-material-currency", "description": "Campo de moeda com máscara, localização e validação.", "inputs": [ { "name": "metadata", "type": "MaterialCurrencyMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-material-currency", "friendlyName": "Moeda (Material)", "icon": "attach_money", "tags": [ "widget", "field", "input", "currency", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-currency/material-currency.metadata.ts", "exportName": "PDX_MATERIAL_CURRENCY_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-currency\nSelector: pdx-material-currency\nFriendly Name: Moeda (Material)\nDescription: Campo de moeda com máscara, localização e validação.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, currency, material\nInputs:\n - metadata (MaterialCurrencyMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-currency/material-currency.metadata.ts", "contentHash": "49b25287c65df72d72be92c8a92bd93b72a4852a347e8ed0eaed6a23e4ff68d0", "sourceKind": "component_definition", "sourceId": "pdx-material-currency", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"currency\",\n \"title\": \"Currency controls\",\n \"description\": \"Profile for currency and price-range controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-currency\",\n \"pdx-inline-currency-range\",\n \"pdx-material-currency\",\n \"pdx-material-price-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Currency metadata paths such as currency code, locale, precision and range mode.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.currency.configure\",\n \"title\": \"Configure currency field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"currencyCode\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"rangeMode\": {\n \"enum\": [\n \"single\",\n \"range\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"currency-code-valid\",\n \"currency-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.currencyCode\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.rangeMode\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"currency-code-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP003\",\n \"description\": \"Currency controls require a valid ISO currency code and locale-aware formatting semantics.\"\n },\n {\n \"validatorId\": \"currency-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP004\",\n \"description\": \"Currency range bounds must be ordered and compatible with precision.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-brl-currency\",\n \"request\": \"Configure the currency field for Brazilian Real with two decimals.\",\n \"operationId\": \"field.currency.configure\",\n \"params\": {\n \"currencyCode\": \"BRL\",\n \"locale\": \"pt-BR\",\n \"precision\": 2\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "77f0d05de3620497f1f0270555d45b1d54528f61e2a935815156163846b9acfb", "sourceKind": "component_definition", "sourceId": "pdx-material-currency", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-currency | controlType: currency\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-currency\",\n \"tags\": [\n \"dynamic-fields\",\n \"numeric\"\n ],\n \"useWhen\": \"criar campo currency\",\n \"examplePrompts\": [\n \"crie um campo currency\",\n \"adicione um currency ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_currency\",\n \"label\": \"Example currency\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"currency\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"currency\": \"BRL\",\n \"currencyPosition\": \"before\",\n \"decimalPlaces\": 2,\n \"locale\": \"pt-BR\",\n \"thousandsSeparator\": \".\",\n \"decimalSeparator\": \",\",\n \"allowNegative\": false\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-currency.json", "contentHash": "d8f04ca04375bec89dd1f6c9788a9d93b72e7dc9c2c6adea2782e2ddbcaa96a0", "sourceKind": "component_definition", "sourceId": "pdx-material-currency", "corpusVersion": "1.0.0" } ] }, "pdx-material-date-range": { "id": "pdx-material-date-range", "description": "praxis.dynamicFields.editorial.dateRange.description", "inputs": [ { "name": "metadata", "type": "MaterialDateRangeMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-material-date-range", "friendlyName": "praxis.dynamicFields.editorial.dateRange.friendlyName", "icon": "date_range", "tags": [ "widget", "field", "date", "range", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-date-range/material-date-range.metadata.ts", "exportName": "PDX_MATERIAL_DATE_RANGE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-date-range\nSelector: pdx-material-date-range\nFriendly Name: praxis.dynamicFields.editorial.dateRange.friendlyName\nDescription: praxis.dynamicFields.editorial.dateRange.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, date, range, material\nInputs:\n - metadata (MaterialDateRangeMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-date-range/material-date-range.metadata.ts", "contentHash": "925e6a5652bab07dd5359a02f3c50a43efc19eea60301253366f54bb3d44e837", "sourceKind": "component_definition", "sourceId": "pdx-material-date-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date-range\",\n \"title\": \"Date range controls\",\n \"description\": \"Profile for date range, month range, year range, period and relative-period controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-date-range\",\n \"pdx-inline-month-range\",\n \"pdx-inline-period-range\",\n \"pdx-inline-relative-period\",\n \"pdx-inline-year-range\",\n \"pdx-material-date-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date range metadata paths such as start/end field mapping, min/max and presets.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.dateRange.configure\",\n \"title\": \"Configure date range field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"startField\": {\n \"type\": \"string\"\n },\n \"endField\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"presets\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"date-range-fields-valid\",\n \"temporal-bounds-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.startField\",\n \"fieldMetadata.endField\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.presets\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"date-range-fields-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP013\",\n \"description\": \"Date range controls require distinct start/end field semantics and ordered submitted values.\"\n },\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-range-fields\",\n \"request\": \"Use createdFrom and createdTo as the date range field names.\",\n \"operationId\": \"field.dateRange.configure\",\n \"params\": {\n \"startField\": \"createdFrom\",\n \"endField\": \"createdTo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "341f9bca8da5ec291232bdda90ba13821bb60134fc7892d9e14078948696da03", "sourceKind": "component_definition", "sourceId": "pdx-material-date-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-date-range | controlType: dateRange | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-date-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"date-range\"\n ],\n \"useWhen\": \"filtrar ou cadastrar período de início e fim\",\n \"examplePrompts\": [\n \"crie um campo dateRange para período\",\n \"adicione dateRange para janela de criação\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"createdAtRange\",\n \"label\": \"Período de criação\",\n \"placeholder\": \"Início até Fim\",\n \"controlType\": \"dateRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de período de criação\"\n },\n \"rangeSeparator\": \"até\",\n \"startPlaceholder\": \"Início\",\n \"endPlaceholder\": \"Fim\",\n \"minDate\": \"2024-01-01\",\n \"maxDate\": \"2026-12-31\",\n \"ariaLabel\": \"Seletor de período de datas\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-date-range.json", "contentHash": "d26b1b9500a7b6560a3d8bb17c0aa7a5cb7a58ee6451f8ab47ea2679a1289eb4", "sourceKind": "component_definition", "sourceId": "pdx-material-date-range", "corpusVersion": "1.0.0" } ] }, "pdx-material-datepicker": { "id": "pdx-material-datepicker", "description": "praxis.dynamicFields.editorial.datePicker.description", "inputs": [ { "name": "metadata", "type": "MaterialDatepickerMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-material-datepicker", "friendlyName": "praxis.dynamicFields.editorial.datePicker.friendlyName", "icon": "event", "tags": [ "widget", "field", "date", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-datepicker/material-datepicker.metadata.ts", "exportName": "PDX_MATERIAL_DATEPICKER_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-datepicker\nSelector: pdx-material-datepicker\nFriendly Name: praxis.dynamicFields.editorial.datePicker.friendlyName\nDescription: praxis.dynamicFields.editorial.datePicker.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, date, material\nInputs:\n - metadata (MaterialDatepickerMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-datepicker/material-datepicker.metadata.ts", "contentHash": "14f15072407cc06ca20047b134ca0784c06618b07ea0c296e25e17c2369bdd9e", "sourceKind": "component_definition", "sourceId": "pdx-material-datepicker", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date\",\n \"title\": \"Date controls\",\n \"description\": \"Profile for single date, datetime, month, week, year and time picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-date-input\",\n \"pdx-datetime-local-input\",\n \"pdx-inline-date\",\n \"pdx-inline-time\",\n \"pdx-material-datepicker\",\n \"pdx-material-timepicker\",\n \"pdx-month-input\",\n \"pdx-time-input\",\n \"pdx-week-input\",\n \"pdx-year-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date/time metadata paths such as min, max, timezone, locale and format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.date.configure\",\n \"title\": \"Configure date or time field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"timezone\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"temporal-bounds-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.timezone\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.format\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-min-max\",\n \"request\": \"Limit the date field to the current year in Sao Paulo timezone.\",\n \"operationId\": \"field.date.configure\",\n \"params\": {\n \"min\": \"2026-01-01\",\n \"max\": \"2026-12-31\",\n \"timezone\": \"America/Sao_Paulo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "08eab5ad75f996b139ebddd730883a5cd6895567e2c3a16cafc4ddf60e53b185", "sourceKind": "component_definition", "sourceId": "pdx-material-datepicker", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-datepicker | controlType: date | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-datepicker\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"material-datepicker\"\n ],\n \"useWhen\": \"escolher datas com contexto visual de calendário\",\n \"examplePrompts\": [\n \"crie um campo date com calendário\",\n \"adicione material datepicker para data limite\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"dueDate\",\n \"label\": \"Data limite\",\n \"placeholder\": \"dd/mm/aaaa\",\n \"controlType\": \"date\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de data limite\"\n },\n \"minDate\": \"2024-01-01\",\n \"maxDate\": \"2026-12-31\",\n \"startView\": \"month\",\n \"touchUi\": false,\n \"datepickerTogglePosition\": \"suffix\",\n \"ariaLabel\": \"Seletor de data limite\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-datepicker.json", "contentHash": "7830baa3816f63cb1f7dfde5e7769a12f48c21cb863d8c68875deeace4370451", "sourceKind": "component_definition", "sourceId": "pdx-material-datepicker", "corpusVersion": "1.0.0" } ] }, "pdx-material-file-upload": { "id": "pdx-material-file-upload", "description": "praxis.dynamicFields.editorial.fileUpload.description", "inputs": [ { "name": "metadata", "type": "ComponentMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-file-upload", "friendlyName": "praxis.dynamicFields.editorial.fileUpload.friendlyName", "icon": "upload_file", "tags": [ "widget", "file", "upload", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-file-upload/material-file-upload.metadata.ts", "exportName": "PDX_MATERIAL_FILE_UPLOAD_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-file-upload\nSelector: pdx-material-file-upload\nFriendly Name: praxis.dynamicFields.editorial.fileUpload.friendlyName\nDescription: praxis.dynamicFields.editorial.fileUpload.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, file, upload, material\nInputs:\n - metadata (ComponentMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-file-upload/material-file-upload.metadata.ts", "contentHash": "554423ac0b7f2cd3fb3048ab326abd67be139e5fe47a751bcc9493427ca70428", "sourceKind": "component_definition", "sourceId": "pdx-material-file-upload", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"file-upload\",\n \"title\": \"File upload controls\",\n \"description\": \"Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-file-upload\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.fileUpload.configure\",\n \"title\": \"Configure file upload field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"accept\": {\n \"type\": \"array\"\n },\n \"maxFileSize\": {\n \"type\": \"number\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"maxFiles\": {\n \"type\": \"number\"\n },\n \"uploadEndpoint\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"file-upload-policy-valid\",\n \"file-upload-endpoint-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.accept\",\n \"fieldMetadata.maxFileSize\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.maxFiles\",\n \"fieldMetadata.uploadEndpoint\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"file-upload-policy-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP020\",\n \"description\": \"File upload controls require explicit file type, size and multiplicity constraints before storage binding.\"\n },\n {\n \"validatorId\": \"file-upload-endpoint-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP021\",\n \"description\": \"Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-pdf-upload\",\n \"request\": \"Allow up to three PDF files with a five megabyte limit.\",\n \"operationId\": \"field.fileUpload.configure\",\n \"params\": {\n \"accept\": [\n \"application/pdf\"\n ],\n \"maxFileSize\": 5242880,\n \"multiple\": true,\n \"maxFiles\": 3\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "ba7802568a1979af465fa4d17c9ae63f44ed1ba89039e248178d78b4984510e9", "sourceKind": "component_definition", "sourceId": "pdx-material-file-upload", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-file-upload | controlType: upload\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-file-upload\",\n \"tags\": [\n \"dynamic-fields\",\n \"file\"\n ],\n \"useWhen\": \"criar campo upload\",\n \"examplePrompts\": [\n \"crie um campo upload\",\n \"adicione um upload ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_upload\",\n \"label\": \"Example upload\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"upload\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-file-upload.json", "contentHash": "cc4867db584db72eae9306adb0f9dbe7348783c770ae7915d082478c7e0994f2", "sourceKind": "component_definition", "sourceId": "pdx-material-file-upload", "corpusVersion": "1.0.0" } ] }, "pdx-material-multi-select": { "id": "pdx-material-multi-select", "description": "Seleção múltipla com opções estáticas ou remotas.", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-multi-select", "friendlyName": "Multi-select (Material)", "icon": "playlist_add_check", "tags": [ "widget", "field", "select", "multi", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-multi-select/material-multi-select.metadata.ts", "exportName": "PDX_MATERIAL_MULTI_SELECT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-multi-select\nSelector: pdx-material-multi-select\nFriendly Name: Multi-select (Material)\nDescription: Seleção múltipla com opções estáticas ou remotas.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, select, multi, material\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-multi-select/material-multi-select.metadata.ts", "contentHash": "0640f6984e0e381593e8efcef7fa9d9b5e9a5746f2ab401f04d7e32b7e9ce13b", "sourceKind": "component_definition", "sourceId": "pdx-material-multi-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-material-multi-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-multi-select | controlType: multiSelect\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-multi-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo multiSelect\",\n \"examplePrompts\": [\n \"crie um campo multiSelect\",\n \"adicione um multiSelect ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_multiSelect\",\n \"label\": \"Example multiSelect\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"multiSelect\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-multi-select.json", "contentHash": "67a4cb25abf4fa3e671d964f1cffe028120b7f0c68bdc9e85a50717a7a5c026b", "sourceKind": "component_definition", "sourceId": "pdx-material-multi-select", "corpusVersion": "1.0.0" } ] }, "pdx-material-multi-select-tree": { "id": "pdx-material-multi-select-tree", "description": "Seleção múltipla hierárquica com suporte a grandes listas.", "inputs": [ { "name": "metadata", "type": "MaterialMultiSelectTreeMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-multi-select-tree", "friendlyName": "Multi-select em árvore (Material)", "icon": "account_tree", "tags": [ "widget", "field", "select", "tree", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-multi-select-tree/material-multi-select-tree.metadata.ts", "exportName": "PDX_MATERIAL_MULTI_SELECT_TREE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-multi-select-tree\nSelector: pdx-material-multi-select-tree\nFriendly Name: Multi-select em árvore (Material)\nDescription: Seleção múltipla hierárquica com suporte a grandes listas.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, select, tree, material\nInputs:\n - metadata (MaterialMultiSelectTreeMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-multi-select-tree/material-multi-select-tree.metadata.ts", "contentHash": "71cacb9cec13dd709d0154e5ac1893a1ec65c2a36fe38b5b41f256e8b10548ef", "sourceKind": "component_definition", "sourceId": "pdx-material-multi-select-tree", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"tree-select\",\n \"title\": \"Tree select controls\",\n \"description\": \"Profile for hierarchical tree select controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-tree-select\",\n \"pdx-material-multi-select-tree\",\n \"pdx-material-tree-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.treeSelect.configure\",\n \"title\": \"Configure tree select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"nodeIdField\": {\n \"type\": \"string\"\n },\n \"parentIdField\": {\n \"type\": \"string\"\n },\n \"childrenField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"lazyLoad\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"tree-node-identity-valid\",\n \"tree-option-source-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.nodeIdField\",\n \"fieldMetadata.parentIdField\",\n \"fieldMetadata.childrenField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.lazyLoad\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"tree-node-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP008\",\n \"description\": \"Tree controls require stable node identity and valid parent/children references.\"\n },\n {\n \"validatorId\": \"tree-option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP009\",\n \"description\": \"Tree option sources must expose hierarchical data compatible with the configured node fields.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-tree-select\",\n \"request\": \"Configure tree select with id, parentId and children fields.\",\n \"operationId\": \"field.treeSelect.configure\",\n \"params\": {\n \"nodeIdField\": \"id\",\n \"parentIdField\": \"parentId\",\n \"childrenField\": \"children\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "67bf3826cde32728907417376c021d9c845f4c51dccf855a8c4cae621c905234", "sourceKind": "component_definition", "sourceId": "pdx-material-multi-select-tree", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-multi-select-tree | controlType: multiSelectTree\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-multi-select-tree\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo multiSelectTree\",\n \"examplePrompts\": [\n \"crie um campo multiSelectTree\",\n \"adicione um multiSelectTree ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_multiSelectTree\",\n \"label\": \"Example multiSelectTree\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"multiSelectTree\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-multi-select-tree.json", "contentHash": "e64264fb424d7e519b5ef338b58a99bedf718203a154c3fbe5c7cba4c55cb185", "sourceKind": "component_definition", "sourceId": "pdx-material-multi-select-tree", "corpusVersion": "1.0.0" } ] }, "pdx-material-price-range": { "id": "pdx-material-price-range", "description": "Dois campos de moeda integrados para faixa de valores.", "inputs": [ { "name": "metadata", "type": "MaterialPriceRangeMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-material-price-range", "friendlyName": "Intervalo de preço (Material)", "icon": "price_change", "tags": [ "widget", "field", "currency", "range", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-price-range/material-price-range.metadata.ts", "exportName": "PDX_MATERIAL_PRICE_RANGE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-price-range\nSelector: pdx-material-price-range\nFriendly Name: Intervalo de preço (Material)\nDescription: Dois campos de moeda integrados para faixa de valores.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, currency, range, material\nInputs:\n - metadata (MaterialPriceRangeMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-price-range/material-price-range.metadata.ts", "contentHash": "15960d6f865cb57b74cee241eabe326ccfd7aea6020ea3e1df443b74f9df7820", "sourceKind": "component_definition", "sourceId": "pdx-material-price-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"currency\",\n \"title\": \"Currency controls\",\n \"description\": \"Profile for currency and price-range controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-currency\",\n \"pdx-inline-currency-range\",\n \"pdx-material-currency\",\n \"pdx-material-price-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Currency metadata paths such as currency code, locale, precision and range mode.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.currency.configure\",\n \"title\": \"Configure currency field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"currencyCode\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"rangeMode\": {\n \"enum\": [\n \"single\",\n \"range\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"currency-code-valid\",\n \"currency-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.currencyCode\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.rangeMode\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"currency-code-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP003\",\n \"description\": \"Currency controls require a valid ISO currency code and locale-aware formatting semantics.\"\n },\n {\n \"validatorId\": \"currency-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP004\",\n \"description\": \"Currency range bounds must be ordered and compatible with precision.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-brl-currency\",\n \"request\": \"Configure the currency field for Brazilian Real with two decimals.\",\n \"operationId\": \"field.currency.configure\",\n \"params\": {\n \"currencyCode\": \"BRL\",\n \"locale\": \"pt-BR\",\n \"precision\": 2\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "77f0d05de3620497f1f0270555d45b1d54528f61e2a935815156163846b9acfb", "sourceKind": "component_definition", "sourceId": "pdx-material-price-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-price-range | controlType: priceRange\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-price-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"numeric\"\n ],\n \"useWhen\": \"criar campo priceRange\",\n \"examplePrompts\": [\n \"crie um campo priceRange\",\n \"adicione um priceRange ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_priceRange\",\n \"label\": \"Example priceRange\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"priceRange\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"min\": 1,\n \"max\": 1,\n \"step\": 1,\n \"currency\": \"BRL\",\n \"currencyPosition\": \"before\",\n \"decimalPlaces\": 2,\n \"locale\": \"pt-BR\",\n \"thousandsSeparator\": \".\",\n \"decimalSeparator\": \",\",\n \"allowNegative\": false,\n \"startPlaceholder\": \"Min\",\n \"endPlaceholder\": \"Max\",\n \"startLabel\": \"Min\",\n \"endLabel\": \"Max\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-price-range.json", "contentHash": "90114e0ade8420990f574bc2e97b439827025b08848ba8ac92229b2356de3aa9", "sourceKind": "component_definition", "sourceId": "pdx-material-price-range", "corpusVersion": "1.0.0" } ] }, "pdx-material-radio-group": { "id": "pdx-material-radio-group", "description": "praxis.dynamicFields.editorial.radioGroup.description", "inputs": [ { "name": "metadata", "type": "MaterialRadioMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-radio-group", "friendlyName": "praxis.dynamicFields.editorial.radioGroup.friendlyName", "icon": "radio_button_checked", "tags": [ "widget", "field", "radio", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-radio-group/material-radio-group.metadata.ts", "exportName": "PDX_MATERIAL_RADIO_GROUP_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-radio-group\nSelector: pdx-material-radio-group\nFriendly Name: praxis.dynamicFields.editorial.radioGroup.friendlyName\nDescription: praxis.dynamicFields.editorial.radioGroup.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, radio, material\nInputs:\n - metadata (MaterialRadioMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-radio-group/material-radio-group.metadata.ts", "contentHash": "e8b3453a5c33cde4742fc2a5504e47d80c17deadb870fa3f0a457083956bc36c", "sourceKind": "component_definition", "sourceId": "pdx-material-radio-group", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-material-radio-group", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-radio-group | controlType: radio\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-radio-group\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo radio\",\n \"examplePrompts\": [\n \"crie um campo radio\",\n \"adicione um radio ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_radio\",\n \"label\": \"Example radio\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"radio\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-radio-group.json", "contentHash": "83fccfc58284e49f9ae3311360fb071e4babbc34209db2e36c2708c0821acd88", "sourceKind": "component_definition", "sourceId": "pdx-material-radio-group", "corpusVersion": "1.0.0" } ] }, "pdx-material-range-slider": { "id": "pdx-material-range-slider", "description": "Slider simples ou de intervalo com validações customizadas.", "inputs": [ { "name": "metadata", "type": "MaterialRangeSliderMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-range-slider", "friendlyName": "Range Slider (Material)", "icon": "tune", "tags": [ "widget", "field", "slider", "range", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-range-slider/material-range-slider.metadata.ts", "exportName": "PDX_MATERIAL_RANGE_SLIDER_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-range-slider\nSelector: pdx-material-range-slider\nFriendly Name: Range Slider (Material)\nDescription: Slider simples ou de intervalo com validações customizadas.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, slider, range, material\nInputs:\n - metadata (MaterialRangeSliderMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-range-slider/material-range-slider.metadata.ts", "contentHash": "37a2c859819ddf17f8ac4ee0d90556f841b6ffa3fe80b7d1f26f7ea478c43571", "sourceKind": "component_definition", "sourceId": "pdx-material-range-slider", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"numeric\",\n \"title\": \"Numeric controls\",\n \"description\": \"Profile for number, slider, range, rating, distance and score controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-distance-radius\",\n \"pdx-inline-number\",\n \"pdx-inline-range-slider\",\n \"pdx-inline-rating\",\n \"pdx-inline-score-priority\",\n \"pdx-material-range-slider\",\n \"pdx-material-rating\",\n \"pdx-material-slider\",\n \"pdx-number-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Numeric metadata paths such as min, max, step, precision and display format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.numeric.configure\",\n \"title\": \"Configure numeric field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"step\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"displayFormat\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"numeric-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.step\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.displayFormat\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"numeric-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP002\",\n \"description\": \"Numeric min, max, step and precision must be mutually valid for the target control.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-rating-scale\",\n \"request\": \"Set rating control to five points with half-step increments.\",\n \"operationId\": \"field.numeric.configure\",\n \"params\": {\n \"min\": 0,\n \"max\": 5,\n \"step\": 0.5\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "356c72bdee9ea6470f4037c40e9e605bf4557caa37fc1f16b9dc0a8fa63880e6", "sourceKind": "component_definition", "sourceId": "pdx-material-range-slider", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-range-slider | controlType: rangeSlider\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-range-slider\",\n \"tags\": [\"dynamic-fields\", \"numeric\"],\n \"useWhen\": \"criar campo rangeSlider\",\n \"examplePrompts\": [\n \"crie um campo rangeSlider\",\n \"adicione um rangeSlider ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_rangeSlider\",\n \"label\": \"Example rangeSlider\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"rangeSlider\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\"form\"],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\"status\"],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"min\": 1,\n \"max\": 1,\n \"step\": 1,\n \"thumbLabel\": true,\n \"valueLabelDisplay\": \"on\",\n \"valueLabelFormat\": \"compact\",\n \"showTicks\": true,\n \"marks\": [\n {\n \"value\": 0,\n \"label\": \"Min\"\n },\n {\n \"value\": 50,\n \"label\": \"Target\",\n \"tone\": \"info\"\n },\n {\n \"value\": 100,\n \"label\": \"Max\"\n }\n ],\n \"semanticBands\": [\n {\n \"start\": 0,\n \"end\": 40,\n \"label\": \"Low range\",\n \"tone\": \"success\"\n },\n {\n \"start\": 40,\n \"end\": 75,\n \"label\": \"Target range\",\n \"tone\": \"info\"\n },\n {\n \"start\": 75,\n \"end\": 100,\n \"label\": \"High range\",\n \"tone\": \"danger\"\n }\n ],\n \"distribution\": {\n \"colorMode\": \"gradient\",\n \"gradientStartColor\": \"var(--md-sys-color-primary)\",\n \"gradientEndColor\": \"var(--md-sys-color-tertiary)\",\n \"bins\": [3, 9, 16, 11, 5],\n \"maxValue\": 16\n },\n \"track\": \"normal\",\n \"size\": \"medium\",\n \"vertical\": true,\n \"invert\": true\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-range-slider.json", "contentHash": "2c1e55d7ad04f9c0a2112663c6869f106926f948d0370aac59a265dfa132c316", "sourceKind": "component_definition", "sourceId": "pdx-material-range-slider", "corpusVersion": "1.0.0" } ] }, "pdx-material-rating": { "id": "pdx-material-rating", "description": "Avaliação por ícones com meia-estrela e acessibilidade.", "inputs": [ { "name": "metadata", "type": "MaterialRatingMetadata", "required": false }, { "name": "itemsCount", "type": "number", "required": false }, { "name": "selection", "type": "'continuous'|'single'", "required": false }, { "name": "allowHalf", "type": "boolean", "required": false }, { "name": "precision", "type": "'item'|'half'", "required": false }, { "name": "label", "type": "string", "required": false }, { "name": "icon", "type": "string", "required": false }, { "name": "svgIcon", "type": "string", "required": false }, { "name": "svgIconOutline", "type": "string", "required": false }, { "name": "disabled", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false }, { "name": "tabindex", "type": "number", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-rating", "friendlyName": "Rating (Material)", "icon": "star", "tags": [ "widget", "field", "rating", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-rating/material-rating.metadata.ts", "exportName": "PDX_MATERIAL_RATING_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-rating\nSelector: pdx-material-rating\nFriendly Name: Rating (Material)\nDescription: Avaliação por ícones com meia-estrela e acessibilidade.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, rating, material\nInputs:\n - metadata (MaterialRatingMetadata)\n - itemsCount (number)\n - selection ('continuous'|'single')\n - allowHalf (boolean)\n - precision ('item'|'half')\n - label (string)\n - icon (string)\n - svgIcon (string)\n - svgIconOutline (string)\n - disabled (boolean)\n - disabledMode (boolean)\n - readonlyMode (boolean)\n - presentationMode (boolean)\n - tabindex (number)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-rating/material-rating.metadata.ts", "contentHash": "817eec5293b69892e52f2295518a49ba564b40bef1f40465865b996db6573753", "sourceKind": "component_definition", "sourceId": "pdx-material-rating", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"numeric\",\n \"title\": \"Numeric controls\",\n \"description\": \"Profile for number, slider, range, rating, distance and score controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-distance-radius\",\n \"pdx-inline-number\",\n \"pdx-inline-range-slider\",\n \"pdx-inline-rating\",\n \"pdx-inline-score-priority\",\n \"pdx-material-range-slider\",\n \"pdx-material-rating\",\n \"pdx-material-slider\",\n \"pdx-number-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Numeric metadata paths such as min, max, step, precision and display format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.numeric.configure\",\n \"title\": \"Configure numeric field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"step\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"displayFormat\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"numeric-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.step\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.displayFormat\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"numeric-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP002\",\n \"description\": \"Numeric min, max, step and precision must be mutually valid for the target control.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-rating-scale\",\n \"request\": \"Set rating control to five points with half-step increments.\",\n \"operationId\": \"field.numeric.configure\",\n \"params\": {\n \"min\": 0,\n \"max\": 5,\n \"step\": 0.5\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "356c72bdee9ea6470f4037c40e9e605bf4557caa37fc1f16b9dc0a8fa63880e6", "sourceKind": "component_definition", "sourceId": "pdx-material-rating", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-rating | controlType: rating\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-rating\",\n \"tags\": [\n \"dynamic-fields\",\n \"action\"\n ],\n \"useWhen\": \"criar campo rating\",\n \"examplePrompts\": [\n \"crie um campo rating\",\n \"adicione um rating ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_rating\",\n \"label\": \"Example rating\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"rating\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"icon\": \"example\",\n \"color\": \"primary\",\n \"size\": \"small\",\n \"max\": 1,\n \"allowHalf\": true,\n \"emptyIcon\": \"mi:star_border\",\n \"selection\": \"continuous\",\n \"ratingColor\": \"#fbc02d\",\n \"outlineColor\": \"rgba(0,0,0,0.38)\",\n \"tabIndex\": 0\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-rating.json", "contentHash": "7fc6ae83c88f6f9b8564d4ec0e3a632fff4afcd80ab9b5194e16fdac457708e6", "sourceKind": "component_definition", "sourceId": "pdx-material-rating", "corpusVersion": "1.0.0" } ] }, "pdx-material-searchable-select": { "id": "pdx-material-searchable-select", "description": "Select com caixa de busca embutida e opções remotas.", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-searchable-select", "friendlyName": "Select com busca (Material)", "icon": "search", "tags": [ "widget", "field", "select", "search", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-searchable-select/material-searchable-select.metadata.ts", "exportName": "PDX_MATERIAL_SEARCHABLE_SELECT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-searchable-select\nSelector: pdx-material-searchable-select\nFriendly Name: Select com busca (Material)\nDescription: Select com caixa de busca embutida e opções remotas.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, select, search, material\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-searchable-select/material-searchable-select.metadata.ts", "contentHash": "0de916d321f8d4cb036770eebba51e87c92683fc21c94ea3add32fddb3931960", "sourceKind": "component_definition", "sourceId": "pdx-material-searchable-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-material-searchable-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-searchable-select | controlType: searchable-select\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-searchable-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"base\"\n ],\n \"useWhen\": \"criar campo searchable-select\",\n \"examplePrompts\": [\n \"crie um campo searchable-select\",\n \"adicione um searchable-select ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_searchable_select\",\n \"label\": \"Example searchable-select\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"searchable-select\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"loadOn\": \"open\",\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n },\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-searchable-select.json", "contentHash": "bac8907b9dd84a454aaf3089b018e1db97d9229304dab2543201f34925504660", "sourceKind": "component_definition", "sourceId": "pdx-material-searchable-select", "corpusVersion": "1.0.0" } ] }, "pdx-material-select": { "id": "pdx-material-select", "description": "praxis.dynamicFields.editorial.select.description", "inputs": [ { "name": "metadata", "type": "MaterialSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-select", "friendlyName": "praxis.dynamicFields.editorial.select.friendlyName", "icon": "arrow_drop_down_circle", "tags": [ "widget", "field", "select", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-select/material-select.metadata.ts", "exportName": "PDX_MATERIAL_SELECT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-select\nSelector: pdx-material-select\nFriendly Name: praxis.dynamicFields.editorial.select.friendlyName\nDescription: praxis.dynamicFields.editorial.select.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, select, material\nInputs:\n - metadata (MaterialSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-select/material-select.metadata.ts", "contentHash": "a1b4ef0ec1e2d38fa1fb1f25f34379f06e2c38d91366221af81e64c7088802be", "sourceKind": "component_definition", "sourceId": "pdx-material-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e7c822f2048dffd972bf61a378d993284d7620b4ee6cc4db2920bdc1fff24633", "sourceKind": "component_definition", "sourceId": "pdx-material-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-select | controlType: select\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo select\",\n \"examplePrompts\": [\n \"crie um campo select\",\n \"adicione um select ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_select\",\n \"label\": \"Example select\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"select\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-select.json", "contentHash": "a5d63debe4f29f0054012f1d99f93a05b5b32c14b58d3848a89e7a1ddee7554f", "sourceKind": "component_definition", "sourceId": "pdx-material-select", "corpusVersion": "1.0.0" } ] }, "pdx-material-selection-list": { "id": "pdx-material-selection-list", "description": "Lista de seleção múltipla baseada em MatSelectionList.", "inputs": [ { "name": "metadata", "type": "MaterialSelectionListMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-selection-list", "friendlyName": "Selection List (Material)", "icon": "fact_check", "tags": [ "widget", "field", "list", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-selection-list/material-selection-list.metadata.ts", "exportName": "PDX_MATERIAL_SELECTION_LIST_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-selection-list\nSelector: pdx-material-selection-list\nFriendly Name: Selection List (Material)\nDescription: Lista de seleção múltipla baseada em MatSelectionList.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, list, material\nInputs:\n - metadata (MaterialSelectionListMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-selection-list/material-selection-list.metadata.ts", "contentHash": "f07e794a5accd5f3b25213978498a422360d0c6e10964a3ae81d06c0a7297171", "sourceKind": "component_definition", "sourceId": "pdx-material-selection-list", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"list-transfer\",\n \"title\": \"List and transfer controls\",\n \"description\": \"Profile for selection-list and transfer-list controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-selection-list\",\n \"pdx-material-transfer-list\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"List option metadata paths such as options, selection mode, value field and ordering.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.list.configure\",\n \"title\": \"Configure list field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"options\": {\n \"type\": \"array\"\n },\n \"transferOptions\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"ordered\": {\n \"type\": \"boolean\"\n },\n \"maxSelections\": {\n \"type\": \"number\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"list-selection-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.options\",\n \"fieldMetadata.transferOptions\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.ordered\",\n \"fieldMetadata.maxSelections\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"list-selection-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP010\",\n \"description\": \"List selection metadata must preserve stable option identity and selected value shape.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-transfer-list\",\n \"request\": \"Configure transfer list to store ids and display labels with a maximum of three selected items.\",\n \"operationId\": \"field.list.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"multiple\": true,\n \"ordered\": true,\n \"maxSelections\": 3\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "c665ec2ebfb1c312119081bedb3ed1f124644b6dc0d2d2a4d9940def3a5f23cc", "sourceKind": "component_definition", "sourceId": "pdx-material-selection-list", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-selection-list | controlType: selectionList\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-selection-list\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo selectionList\",\n \"examplePrompts\": [\n \"crie um campo selectionList\",\n \"adicione um selectionList ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_selectionList\",\n \"label\": \"Example selectionList\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"selectionList\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-selection-list.json", "contentHash": "fe2aa8dae55be0a1369dea6e8560ba7bf027fed89474dc043b9d187579e7db01", "sourceKind": "component_definition", "sourceId": "pdx-material-selection-list", "corpusVersion": "1.0.0" } ] }, "pdx-material-slide-toggle": { "id": "pdx-material-slide-toggle", "description": "praxis.dynamicFields.editorial.toggle.description", "inputs": [ { "name": "metadata", "type": "MaterialToggleMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-slide-toggle", "friendlyName": "praxis.dynamicFields.editorial.toggle.friendlyName", "icon": "toggle_on", "tags": [ "widget", "field", "toggle", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-slide-toggle/material-slide-toggle.metadata.ts", "exportName": "PDX_MATERIAL_SLIDE_TOGGLE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-slide-toggle\nSelector: pdx-material-slide-toggle\nFriendly Name: praxis.dynamicFields.editorial.toggle.friendlyName\nDescription: praxis.dynamicFields.editorial.toggle.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, toggle, material\nInputs:\n - metadata (MaterialToggleMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-slide-toggle/material-slide-toggle.metadata.ts", "contentHash": "1a09df80204579fce29abfbcd689157a64f1f0d91204b51f6c76959c3ae26b34", "sourceKind": "component_definition", "sourceId": "pdx-material-slide-toggle", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"toggle\",\n \"title\": \"Toggle controls\",\n \"description\": \"Profile for boolean toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-toggle\",\n \"pdx-material-slide-toggle\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Boolean metadata paths such as true label, false label and default value.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.toggle.configure\",\n \"title\": \"Configure toggle field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"trueLabel\": {\n \"type\": \"string\"\n },\n \"falseLabel\": {\n \"type\": \"string\"\n },\n \"defaultValue\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"boolean-toggle-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.trueLabel\",\n \"fieldMetadata.falseLabel\",\n \"fieldMetadata.defaultValue\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"boolean-toggle-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP015\",\n \"description\": \"Toggle controls must preserve boolean value semantics and not serialize labels as submitted values.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-toggle-labels\",\n \"request\": \"Set yes/no labels for a toggle without changing boolean submission.\",\n \"operationId\": \"field.toggle.configure\",\n \"params\": {\n \"trueLabel\": \"Yes\",\n \"falseLabel\": \"No\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e936b67bb4d83c38589cd2bbac1eb0acf8a35e18ff28cc6b8155f753d188d449", "sourceKind": "component_definition", "sourceId": "pdx-material-slide-toggle", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-slide-toggle | controlType: toggle\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-slide-toggle\",\n \"tags\": [\n \"dynamic-fields\",\n \"base\"\n ],\n \"useWhen\": \"criar campo toggle\",\n \"examplePrompts\": [\n \"crie um campo toggle\",\n \"adicione um toggle ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_toggle\",\n \"label\": \"Example toggle\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"toggle\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-slide-toggle.json", "contentHash": "1bd94d416385c28ab21d3eec8698a7da9b941a9545aaa1fdaf2b407db5cf10cf", "sourceKind": "component_definition", "sourceId": "pdx-material-slide-toggle", "corpusVersion": "1.0.0" } ] }, "pdx-material-slider": { "id": "pdx-material-slider", "description": "Controle deslizante com valores mínimo/máximo e step.", "inputs": [ { "name": "metadata", "type": "MaterialSliderMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-slider", "friendlyName": "Slider (Material)", "icon": "linear_scale", "tags": [ "widget", "field", "slider", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-slider/material-slider.metadata.ts", "exportName": "PDX_MATERIAL_SLIDER_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-slider\nSelector: pdx-material-slider\nFriendly Name: Slider (Material)\nDescription: Controle deslizante com valores mínimo/máximo e step.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, slider, material\nInputs:\n - metadata (MaterialSliderMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-slider/material-slider.metadata.ts", "contentHash": "10573d597b2d3330b41dab0881d65252bee5b5de9920a370d90b9922887b8989", "sourceKind": "component_definition", "sourceId": "pdx-material-slider", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"numeric\",\n \"title\": \"Numeric controls\",\n \"description\": \"Profile for number, slider, range, rating, distance and score controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-distance-radius\",\n \"pdx-inline-number\",\n \"pdx-inline-range-slider\",\n \"pdx-inline-rating\",\n \"pdx-inline-score-priority\",\n \"pdx-material-range-slider\",\n \"pdx-material-rating\",\n \"pdx-material-slider\",\n \"pdx-number-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Numeric metadata paths such as min, max, step, precision and display format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.numeric.configure\",\n \"title\": \"Configure numeric field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"step\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"displayFormat\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"numeric-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.step\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.displayFormat\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"numeric-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP002\",\n \"description\": \"Numeric min, max, step and precision must be mutually valid for the target control.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-rating-scale\",\n \"request\": \"Set rating control to five points with half-step increments.\",\n \"operationId\": \"field.numeric.configure\",\n \"params\": {\n \"min\": 0,\n \"max\": 5,\n \"step\": 0.5\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "356c72bdee9ea6470f4037c40e9e605bf4557caa37fc1f16b9dc0a8fa63880e6", "sourceKind": "component_definition", "sourceId": "pdx-material-slider", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-slider | controlType: slider\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-slider\",\n \"tags\": [\"dynamic-fields\", \"numeric\"],\n \"useWhen\": \"criar campo slider\",\n \"examplePrompts\": [\n \"crie um campo slider\",\n \"adicione um slider ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_slider\",\n \"label\": \"Example slider\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"slider\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\"form\"],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\"status\"],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"min\": 1,\n \"max\": 1,\n \"step\": 1,\n \"thumbLabel\": true,\n \"valueLabelDisplay\": \"on\",\n \"valueLabelFormat\": \"percent\",\n \"showTicks\": true,\n \"marks\": [\n {\n \"value\": 0,\n \"label\": \"Low\",\n \"tone\": \"success\"\n },\n {\n \"value\": 50,\n \"label\": \"Target\",\n \"tone\": \"info\"\n },\n {\n \"value\": 100,\n \"label\": \"High\",\n \"tone\": \"danger\"\n }\n ],\n \"semanticBands\": [\n {\n \"start\": 0,\n \"end\": 40,\n \"label\": \"Low risk\",\n \"tone\": \"success\"\n },\n {\n \"start\": 40,\n \"end\": 75,\n \"label\": \"Attention\",\n \"tone\": \"warning\"\n },\n {\n \"start\": 75,\n \"end\": 100,\n \"label\": \"Critical\",\n \"tone\": \"danger\"\n }\n ],\n \"distribution\": {\n \"colorMode\": \"selection\",\n \"bins\": [4, 12, 18, 10, 6]\n },\n \"track\": \"normal\",\n \"size\": \"medium\",\n \"vertical\": true,\n \"invert\": true\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-slider.json", "contentHash": "5a01bdb48e7e5843ca818daf8ed15ab0682552ccf6b1ddc5c8cc6beafc971213", "sourceKind": "component_definition", "sourceId": "pdx-material-slider", "corpusVersion": "1.0.0" } ] }, "pdx-material-textarea": { "id": "pdx-material-textarea", "description": "praxis.dynamicFields.editorial.textarea.description", "inputs": [ { "name": "metadata", "type": "MaterialTextareaMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-material-textarea", "friendlyName": "praxis.dynamicFields.editorial.textarea.friendlyName", "icon": "subject", "tags": [ "widget", "field", "textarea", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-textarea/material-textarea.metadata.ts", "exportName": "PDX_MATERIAL_TEXTAREA_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-textarea\nSelector: pdx-material-textarea\nFriendly Name: praxis.dynamicFields.editorial.textarea.friendlyName\nDescription: praxis.dynamicFields.editorial.textarea.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, textarea, material\nInputs:\n - metadata (MaterialTextareaMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-textarea/material-textarea.metadata.ts", "contentHash": "1503af6f70b37e07a52a2426515b48a946f425514208ca1194af4c6bb8851889", "sourceKind": "component_definition", "sourceId": "pdx-material-textarea", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"text-input\",\n \"title\": \"Text input controls\",\n \"description\": \"Profile for text-like controls, including inline and Material text inputs.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-email-input\",\n \"pdx-inline-input\",\n \"pdx-inline-phone\",\n \"pdx-material-textarea\",\n \"pdx-password-input\",\n \"pdx-phone-input\",\n \"pdx-search-input\",\n \"pdx-text-input\",\n \"pdx-url-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.text.configure\",\n \"title\": \"Configure text field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"placeholder\": {\n \"type\": \"string\"\n },\n \"minLength\": {\n \"type\": \"number\"\n },\n \"maxLength\": {\n \"type\": \"number\"\n },\n \"pattern\": {\n \"type\": \"string\"\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"autocomplete\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"text-metadata-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.placeholder\",\n \"fieldMetadata.minLength\",\n \"fieldMetadata.maxLength\",\n \"fieldMetadata.pattern\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.autocomplete\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"text-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP001\",\n \"description\": \"Text constraints must preserve string field semantics and editor/runtime round-trip.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-text-placeholder-and-length\",\n \"request\": \"Set placeholder and maximum length for a text input.\",\n \"operationId\": \"field.text.configure\",\n \"params\": {\n \"placeholder\": \"Search by name\",\n \"maxLength\": 120\n },\n \"isPositive\": true\n }\n ],\n \"roundTripRequirements\": [\n \"Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state.\"\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "c0029e40a022738aabac65b76da38df2467c0f2c2e2e743baebc4841554e762b", "sourceKind": "component_definition", "sourceId": "pdx-material-textarea", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-textarea | controlType: textarea\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-textarea\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo textarea\",\n \"examplePrompts\": [\n \"crie um campo textarea\",\n \"adicione um textarea ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_textarea\",\n \"label\": \"Example textarea\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"textarea\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"rows\": 1,\n \"minRows\": 1,\n \"maxRows\": 1,\n \"resize\": \"none\",\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-textarea.json", "contentHash": "d93a30b67e86f303cdef25d9573aea49dec6b9536a1d3e261567486c58db2160", "sourceKind": "component_definition", "sourceId": "pdx-material-textarea", "corpusVersion": "1.0.0" } ] }, "pdx-material-time-range": { "id": "pdx-material-time-range", "description": "Dois seletores de horário integrados em um único campo.", "inputs": [ { "name": "metadata", "type": "MaterialTimeRangeMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-time-range", "friendlyName": "Intervalo de horário (Material)", "icon": "schedule", "tags": [ "widget", "field", "time", "range", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/pdx-material-time-range/pdx-material-time-range.metadata.ts", "exportName": "PDX_MATERIAL_TIME_RANGE_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-time-range\nSelector: pdx-material-time-range\nFriendly Name: Intervalo de horário (Material)\nDescription: Dois seletores de horário integrados em um único campo.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, time, range, material\nInputs:\n - metadata (MaterialTimeRangeMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/pdx-material-time-range/pdx-material-time-range.metadata.ts", "contentHash": "3def652d798142e8864f6b643bd82210bf527bbb2ff34bdf751d9ffa47a5b763", "sourceKind": "component_definition", "sourceId": "pdx-material-time-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"time-range\",\n \"title\": \"Time range controls\",\n \"description\": \"Profile for time range controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-time-range\",\n \"pdx-material-time-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Time range metadata paths such as start/end fields, step minutes and timezone.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.timeRange.configure\",\n \"title\": \"Configure time range field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"startField\": {\n \"type\": \"string\"\n },\n \"endField\": {\n \"type\": \"string\"\n },\n \"stepMinutes\": {\n \"type\": \"number\"\n },\n \"timezone\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"time-range-fields-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.startField\",\n \"fieldMetadata.endField\",\n \"fieldMetadata.stepMinutes\",\n \"fieldMetadata.timezone\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"time-range-fields-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP014\",\n \"description\": \"Time range controls require distinct start/end field semantics and valid interval steps.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-time-range-step\",\n \"request\": \"Configure a time range with fifteen minute increments.\",\n \"operationId\": \"field.timeRange.configure\",\n \"params\": {\n \"stepMinutes\": 15\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "e8697f568287572f2b796776880dd70ac1d92b971f6ff2a4b27f457cc46fe764", "sourceKind": "component_definition", "sourceId": "pdx-material-time-range", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-time-range | controlType: timeRange | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-time-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"time-range\"\n ],\n \"useWhen\": \"definir janelas horárias com validação de distância\",\n \"examplePrompts\": [\n \"crie um campo timeRange para janela de atendimento\",\n \"adicione timeRange para turno operacional\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"serviceWindow\",\n \"label\": \"Janela de atendimento\",\n \"placeholder\": \"08:00 - 18:00\",\n \"controlType\": \"timeRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de janela de atendimento\"\n },\n \"defaultValue\": {\n \"start\": \"08:00\",\n \"end\": \"18:00\"\n },\n \"validators\": {\n \"minDistance\": 30,\n \"maxDistance\": 720\n },\n \"ariaLabel\": \"Seletor de janela horária\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-time-range.json", "contentHash": "b2b0514b7261d0aa08b7232539e09239194119e806b201b70f337889f92f2f2e", "sourceKind": "component_definition", "sourceId": "pdx-material-time-range", "corpusVersion": "1.0.0" } ] }, "pdx-material-timepicker": { "id": "pdx-material-timepicker", "description": "Selecionador de horário com validação e máscara.", "inputs": [ { "name": "metadata", "type": "MaterialTimepickerMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-material-timepicker", "friendlyName": "Timepicker (Material)", "icon": "schedule", "tags": [ "widget", "field", "time", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-timepicker/material-timepicker.metadata.ts", "exportName": "PDX_MATERIAL_TIMEPICKER_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-timepicker\nSelector: pdx-material-timepicker\nFriendly Name: Timepicker (Material)\nDescription: Selecionador de horário com validação e máscara.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, time, material\nInputs:\n - metadata (MaterialTimepickerMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-timepicker/material-timepicker.metadata.ts", "contentHash": "ea2a15ea5860a1a040e713dc7004eb4bd3d49ccbc0711648ae2a5094dde5dca3", "sourceKind": "component_definition", "sourceId": "pdx-material-timepicker", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date\",\n \"title\": \"Date controls\",\n \"description\": \"Profile for single date, datetime, month, week, year and time picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-date-input\",\n \"pdx-datetime-local-input\",\n \"pdx-inline-date\",\n \"pdx-inline-time\",\n \"pdx-material-datepicker\",\n \"pdx-material-timepicker\",\n \"pdx-month-input\",\n \"pdx-time-input\",\n \"pdx-week-input\",\n \"pdx-year-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date/time metadata paths such as min, max, timezone, locale and format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.date.configure\",\n \"title\": \"Configure date or time field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"timezone\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"temporal-bounds-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.timezone\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.format\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-min-max\",\n \"request\": \"Limit the date field to the current year in Sao Paulo timezone.\",\n \"operationId\": \"field.date.configure\",\n \"params\": {\n \"min\": \"2026-01-01\",\n \"max\": \"2026-12-31\",\n \"timezone\": \"America/Sao_Paulo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "08eab5ad75f996b139ebddd730883a5cd6895567e2c3a16cafc4ddf60e53b185", "sourceKind": "component_definition", "sourceId": "pdx-material-timepicker", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-timepicker | controlType: timePicker | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-timepicker\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"timepicker\"\n ],\n \"useWhen\": \"escolher horário com apoio visual de picker\",\n \"examplePrompts\": [\n \"crie um campo timePicker para reunião\",\n \"adicione timePicker para horário de corte\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"meetingTime\",\n \"label\": \"Horário da reunião\",\n \"placeholder\": \"HH:mm\",\n \"controlType\": \"timePicker\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de horário da reunião\"\n },\n \"stepMinute\": 15,\n \"enableSeconds\": false,\n \"ariaLabel\": \"Seletor de horário da reunião\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-timepicker.json", "contentHash": "a29674b5cb8ac6a98ff5ee3415f022943675a8be0ca7d8a479aeb39b5deb4543", "sourceKind": "component_definition", "sourceId": "pdx-material-timepicker", "corpusVersion": "1.0.0" } ] }, "pdx-material-transfer-list": { "id": "pdx-material-transfer-list", "description": "Lista de transferência com dois painéis (disponíveis/selecionados).", "inputs": [ { "name": "metadata", "type": "MaterialTransferListMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-transfer-list", "friendlyName": "Transfer List (Material)", "icon": "compare_arrows", "tags": [ "widget", "field", "list", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-transfer-list/material-transfer-list.metadata.ts", "exportName": "PDX_MATERIAL_TRANSFER_LIST_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-transfer-list\nSelector: pdx-material-transfer-list\nFriendly Name: Transfer List (Material)\nDescription: Lista de transferência com dois painéis (disponíveis/selecionados).\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, list, material\nInputs:\n - metadata (MaterialTransferListMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-transfer-list/material-transfer-list.metadata.ts", "contentHash": "29a87b05069f5cefe55d3be057f66f079994cd4d072420c0608a81c90bcea0ae", "sourceKind": "component_definition", "sourceId": "pdx-material-transfer-list", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"list-transfer\",\n \"title\": \"List and transfer controls\",\n \"description\": \"Profile for selection-list and transfer-list controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-selection-list\",\n \"pdx-material-transfer-list\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"List option metadata paths such as options, selection mode, value field and ordering.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.list.configure\",\n \"title\": \"Configure list field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"options\": {\n \"type\": \"array\"\n },\n \"transferOptions\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"ordered\": {\n \"type\": \"boolean\"\n },\n \"maxSelections\": {\n \"type\": \"number\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"list-selection-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.options\",\n \"fieldMetadata.transferOptions\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.ordered\",\n \"fieldMetadata.maxSelections\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"list-selection-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP010\",\n \"description\": \"List selection metadata must preserve stable option identity and selected value shape.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-transfer-list\",\n \"request\": \"Configure transfer list to store ids and display labels with a maximum of three selected items.\",\n \"operationId\": \"field.list.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"multiple\": true,\n \"ordered\": true,\n \"maxSelections\": 3\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "c665ec2ebfb1c312119081bedb3ed1f124644b6dc0d2d2a4d9940def3a5f23cc", "sourceKind": "component_definition", "sourceId": "pdx-material-transfer-list", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-transfer-list | controlType: transferList\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-transfer-list\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo transferList\",\n \"examplePrompts\": [\n \"crie um campo transferList\",\n \"adicione um transferList ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_transferList\",\n \"label\": \"Example transferList\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"transferList\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-transfer-list.json", "contentHash": "94489d5cd2238e884fa974f6c31d53a77eab13e0decb34921445b24f7b160aa9", "sourceKind": "component_definition", "sourceId": "pdx-material-transfer-list", "corpusVersion": "1.0.0" } ] }, "pdx-material-tree-select": { "id": "pdx-material-tree-select", "description": "Seleção hierárquica em árvore com busca opcional.", "inputs": [ { "name": "metadata", "type": "MaterialTreeSelectMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-material-tree-select", "friendlyName": "Tree Select (Material)", "icon": "account_tree", "tags": [ "widget", "field", "tree", "select", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/material-tree-select/material-tree-select.metadata.ts", "exportName": "PDX_MATERIAL_TREE_SELECT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-material-tree-select\nSelector: pdx-material-tree-select\nFriendly Name: Tree Select (Material)\nDescription: Seleção hierárquica em árvore com busca opcional.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, tree, select, material\nInputs:\n - metadata (MaterialTreeSelectMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/material-tree-select/material-tree-select.metadata.ts", "contentHash": "7145877d3038fd2d4887d697cb0d45972c38b794cff8b1d065146722a398b817", "sourceKind": "component_definition", "sourceId": "pdx-material-tree-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"tree-select\",\n \"title\": \"Tree select controls\",\n \"description\": \"Profile for hierarchical tree select controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-tree-select\",\n \"pdx-material-multi-select-tree\",\n \"pdx-material-tree-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.treeSelect.configure\",\n \"title\": \"Configure tree select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"nodeIdField\": {\n \"type\": \"string\"\n },\n \"parentIdField\": {\n \"type\": \"string\"\n },\n \"childrenField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"lazyLoad\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"tree-node-identity-valid\",\n \"tree-option-source-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.nodeIdField\",\n \"fieldMetadata.parentIdField\",\n \"fieldMetadata.childrenField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.lazyLoad\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"tree-node-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP008\",\n \"description\": \"Tree controls require stable node identity and valid parent/children references.\"\n },\n {\n \"validatorId\": \"tree-option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP009\",\n \"description\": \"Tree option sources must expose hierarchical data compatible with the configured node fields.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-tree-select\",\n \"request\": \"Configure tree select with id, parentId and children fields.\",\n \"operationId\": \"field.treeSelect.configure\",\n \"params\": {\n \"nodeIdField\": \"id\",\n \"parentIdField\": \"parentId\",\n \"childrenField\": \"children\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "67bf3826cde32728907417376c021d9c845f4c51dccf855a8c4cae621c905234", "sourceKind": "component_definition", "sourceId": "pdx-material-tree-select", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-tree-select | controlType: treeSelect | aliases: treeView\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-tree-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo treeSelect\",\n \"examplePrompts\": [\n \"crie um campo treeSelect\",\n \"adicione um treeSelect ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_treeSelect\",\n \"label\": \"Example treeSelect\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"treeSelect\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-tree-select.json", "contentHash": "64b52505a270c8cc51a0c7461e8323c61d5f448ff007c2a87648fbc332cdcc7a", "sourceKind": "component_definition", "sourceId": "pdx-material-tree-select", "corpusVersion": "1.0.0" } ] }, "pdx-month-input": { "id": "pdx-month-input", "description": "Campo para seleção de mês com validação.", "inputs": [ { "name": "metadata", "type": "MaterialMonthInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-month-input", "friendlyName": "Mês (input)", "icon": "date_range", "tags": [ "widget", "field", "input", "date", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/month-input/month-input.metadata.ts", "exportName": "PDX_MONTH_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-month-input\nSelector: pdx-month-input\nFriendly Name: Mês (input)\nDescription: Campo para seleção de mês com validação.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, date, material\nInputs:\n - metadata (MaterialMonthInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/month-input/month-input.metadata.ts", "contentHash": "5c232e0cb4c7e95a3753136494b1eff5ad7e868cf43dc1a9b7b39f398c4b6cb8", "sourceKind": "component_definition", "sourceId": "pdx-month-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date\",\n \"title\": \"Date controls\",\n \"description\": \"Profile for single date, datetime, month, week, year and time picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-date-input\",\n \"pdx-datetime-local-input\",\n \"pdx-inline-date\",\n \"pdx-inline-time\",\n \"pdx-material-datepicker\",\n \"pdx-material-timepicker\",\n \"pdx-month-input\",\n \"pdx-time-input\",\n \"pdx-week-input\",\n \"pdx-year-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date/time metadata paths such as min, max, timezone, locale and format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.date.configure\",\n \"title\": \"Configure date or time field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"timezone\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"temporal-bounds-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.timezone\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.format\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-min-max\",\n \"request\": \"Limit the date field to the current year in Sao Paulo timezone.\",\n \"operationId\": \"field.date.configure\",\n \"params\": {\n \"min\": \"2026-01-01\",\n \"max\": \"2026-12-31\",\n \"timezone\": \"America/Sao_Paulo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "08eab5ad75f996b139ebddd730883a5cd6895567e2c3a16cafc4ddf60e53b185", "sourceKind": "component_definition", "sourceId": "pdx-month-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-month-input | controlType: month | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-month-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"month\"\n ],\n \"useWhen\": \"trabalhar com competência mensal ou fechamento de ciclo\",\n \"examplePrompts\": [\n \"crie um campo month para competência\",\n \"adicione month para fechamento mensal\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"billingMonth\",\n \"label\": \"Competência\",\n \"placeholder\": \"aaaa-mm\",\n \"controlType\": \"month\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de competência\"\n },\n \"min\": \"2024-01\",\n \"max\": \"2026-12\",\n \"ariaLabel\": \"Campo de competência mensal\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-month-input.json", "contentHash": "8f3a7851a739eb54eb4844a83819906da0edf6875636f599e3f12ae3b81fd255", "sourceKind": "component_definition", "sourceId": "pdx-month-input", "corpusVersion": "1.0.0" } ] }, "pdx-number-input": { "id": "pdx-number-input", "description": "praxis.dynamicFields.editorial.numericTextBox.description", "inputs": [ { "name": "metadata", "type": "MaterialNumericMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-number-input", "friendlyName": "praxis.dynamicFields.editorial.numericTextBox.friendlyName", "icon": "calculate", "tags": [ "widget", "field", "input", "numeric", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/number-input/number-input.metadata.ts", "exportName": "PDX_NUMBER_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-number-input\nSelector: pdx-number-input\nFriendly Name: praxis.dynamicFields.editorial.numericTextBox.friendlyName\nDescription: praxis.dynamicFields.editorial.numericTextBox.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, numeric, material\nInputs:\n - metadata (MaterialNumericMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/number-input/number-input.metadata.ts", "contentHash": "821563dda21e49543656f02c12dc470f24561217407e670200f21b659d356834", "sourceKind": "component_definition", "sourceId": "pdx-number-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"numeric\",\n \"title\": \"Numeric controls\",\n \"description\": \"Profile for number, slider, range, rating, distance and score controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-distance-radius\",\n \"pdx-inline-number\",\n \"pdx-inline-range-slider\",\n \"pdx-inline-rating\",\n \"pdx-inline-score-priority\",\n \"pdx-material-range-slider\",\n \"pdx-material-rating\",\n \"pdx-material-slider\",\n \"pdx-number-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Numeric metadata paths such as min, max, step, precision and display format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.numeric.configure\",\n \"title\": \"Configure numeric field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"step\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"displayFormat\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"numeric-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.step\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.displayFormat\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"numeric-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP002\",\n \"description\": \"Numeric min, max, step and precision must be mutually valid for the target control.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-rating-scale\",\n \"request\": \"Set rating control to five points with half-step increments.\",\n \"operationId\": \"field.numeric.configure\",\n \"params\": {\n \"min\": 0,\n \"max\": 5,\n \"step\": 0.5\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "356c72bdee9ea6470f4037c40e9e605bf4557caa37fc1f16b9dc0a8fa63880e6", "sourceKind": "component_definition", "sourceId": "pdx-number-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-number-input | controlType: numericTextBox\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-number-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"numeric\"\n ],\n \"useWhen\": \"criar campo numericTextBox\",\n \"examplePrompts\": [\n \"crie um campo numericTextBox\",\n \"adicione um numericTextBox ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_numericTextBox\",\n \"label\": \"Example numericTextBox\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"numericTextBox\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"min\": 1,\n \"max\": 1,\n \"step\": 1\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-number-input.json", "contentHash": "87bc4fec83f94bc64c15b440cc3c3f74d9a5c6a5dfe60fb1597f183e485c3581", "sourceKind": "component_definition", "sourceId": "pdx-number-input", "corpusVersion": "1.0.0" } ] }, "pdx-password-input": { "id": "pdx-password-input", "description": "Campo de senha com máscara e alternar visibilidade.", "inputs": [ { "name": "metadata", "type": "MaterialPasswordMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-password-input", "friendlyName": "Senha (input)", "icon": "password", "tags": [ "widget", "field", "input", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/password-input/password-input.metadata.ts", "exportName": "PDX_PASSWORD_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-password-input\nSelector: pdx-password-input\nFriendly Name: Senha (input)\nDescription: Campo de senha com máscara e alternar visibilidade.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, material\nInputs:\n - metadata (MaterialPasswordMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/password-input/password-input.metadata.ts", "contentHash": "e75e4d3e82d9916315c9690ad24f8c1510ce4e09a0ad468de303e2e940ab833f", "sourceKind": "component_definition", "sourceId": "pdx-password-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"text-input\",\n \"title\": \"Text input controls\",\n \"description\": \"Profile for text-like controls, including inline and Material text inputs.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-email-input\",\n \"pdx-inline-input\",\n \"pdx-inline-phone\",\n \"pdx-material-textarea\",\n \"pdx-password-input\",\n \"pdx-phone-input\",\n \"pdx-search-input\",\n \"pdx-text-input\",\n \"pdx-url-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.text.configure\",\n \"title\": \"Configure text field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"placeholder\": {\n \"type\": \"string\"\n },\n \"minLength\": {\n \"type\": \"number\"\n },\n \"maxLength\": {\n \"type\": \"number\"\n },\n \"pattern\": {\n \"type\": \"string\"\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"autocomplete\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"text-metadata-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.placeholder\",\n \"fieldMetadata.minLength\",\n \"fieldMetadata.maxLength\",\n \"fieldMetadata.pattern\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.autocomplete\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"text-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP001\",\n \"description\": \"Text constraints must preserve string field semantics and editor/runtime round-trip.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-text-placeholder-and-length\",\n \"request\": \"Set placeholder and maximum length for a text input.\",\n \"operationId\": \"field.text.configure\",\n \"params\": {\n \"placeholder\": \"Search by name\",\n \"maxLength\": 120\n },\n \"isPositive\": true\n }\n ],\n \"roundTripRequirements\": [\n \"Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state.\"\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "c0029e40a022738aabac65b76da38df2467c0f2c2e2e743baebc4841554e762b", "sourceKind": "component_definition", "sourceId": "pdx-password-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-password-input | controlType: password\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-password-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo password\",\n \"examplePrompts\": [\n \"crie um campo password\",\n \"adicione um password ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_password\",\n \"label\": \"Example password\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"password\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"password\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-password-input.json", "contentHash": "96433f16c49d602b0aaec9c684bbb39e78813a89692e937581e6f37ac1759df1", "sourceKind": "component_definition", "sourceId": "pdx-password-input", "corpusVersion": "1.0.0" } ] }, "pdx-phone-input": { "id": "pdx-phone-input", "description": "praxis.dynamicFields.editorial.phoneInput.description", "inputs": [ { "name": "metadata", "type": "MaterialPhoneMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-phone-input", "friendlyName": "praxis.dynamicFields.editorial.phoneInput.friendlyName", "icon": "call", "tags": [ "widget", "field", "input", "phone", "mask", "validation", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/phone-input/phone-input.metadata.ts", "exportName": "PDX_PHONE_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-phone-input\nSelector: pdx-phone-input\nFriendly Name: praxis.dynamicFields.editorial.phoneInput.friendlyName\nDescription: praxis.dynamicFields.editorial.phoneInput.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, phone, mask, validation, material\nInputs:\n - metadata (MaterialPhoneMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/phone-input/phone-input.metadata.ts", "contentHash": "5069ea679796bce6e17467efadafda5c6e0816cded642280972e3906d611b221", "sourceKind": "component_definition", "sourceId": "pdx-phone-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"text-input\",\n \"title\": \"Text input controls\",\n \"description\": \"Profile for text-like controls, including inline and Material text inputs.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-email-input\",\n \"pdx-inline-input\",\n \"pdx-inline-phone\",\n \"pdx-material-textarea\",\n \"pdx-password-input\",\n \"pdx-phone-input\",\n \"pdx-search-input\",\n \"pdx-text-input\",\n \"pdx-url-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.text.configure\",\n \"title\": \"Configure text field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"placeholder\": {\n \"type\": \"string\"\n },\n \"minLength\": {\n \"type\": \"number\"\n },\n \"maxLength\": {\n \"type\": \"number\"\n },\n \"pattern\": {\n \"type\": \"string\"\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"autocomplete\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"text-metadata-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.placeholder\",\n \"fieldMetadata.minLength\",\n \"fieldMetadata.maxLength\",\n \"fieldMetadata.pattern\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.autocomplete\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"text-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP001\",\n \"description\": \"Text constraints must preserve string field semantics and editor/runtime round-trip.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-text-placeholder-and-length\",\n \"request\": \"Set placeholder and maximum length for a text input.\",\n \"operationId\": \"field.text.configure\",\n \"params\": {\n \"placeholder\": \"Search by name\",\n \"maxLength\": 120\n },\n \"isPositive\": true\n }\n ],\n \"roundTripRequirements\": [\n \"Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state.\"\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "c0029e40a022738aabac65b76da38df2467c0f2c2e2e743baebc4841554e762b", "sourceKind": "component_definition", "sourceId": "pdx-phone-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-phone-input | controlType: phone\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-phone-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"phone\",\n \"mask\",\n \"validation\"\n ],\n \"useWhen\": \"criar campo phone com mascara e validacao telefonica por pais\",\n \"examplePrompts\": [\n \"crie um campo phone com mascara brasileira\",\n \"adicione um telefone validado ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"contact_phone\",\n \"label\": \"Telefone de contato\",\n \"placeholder\": \"(11) 98765-4321\",\n \"hint\": \"Informe o telefone com DDD.\",\n \"tooltip\": \"Telefone validado por pais e normalizado em E.164 quando valido.\",\n \"description\": \"Campo telefonico com mascara progressiva e validacao semantica.\",\n \"group\": \"Contato\",\n \"order\": 1,\n \"width\": \"320px\",\n \"isFlex\": true,\n \"controlType\": \"phone\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"mi:call\",\n \"suffixIcon\": \"mi:verified\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"required\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"+5511987654321\",\n \"ariaLabel\": \"Telefone de contato\",\n \"ariaDescribedBy\": \"contact_phone_hint\",\n \"inputType\": \"tel\",\n \"defaultCountry\": \"BR\",\n \"allowedCountries\": [\n \"BR\"\n ],\n \"phoneFormat\": \"national\",\n \"autoFormat\": true,\n \"validatePhoneNumber\": true\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-phone-input.json", "contentHash": "9347254b87ef4bee39a86c2bbe764861f8fddc5cf267d8ccde78a5f9b21b1018", "sourceKind": "component_definition", "sourceId": "pdx-phone-input", "corpusVersion": "1.0.0" } ] }, "pdx-preload-status": { "id": "pdx-preload-status", "description": "Indicador de carregamento/estado para formulários/listas.", "inputs": [ { "name": "metadata", "type": "any", "required": false }, { "name": "visible", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-preload-status", "friendlyName": "Status de preload", "icon": "hourglass_empty", "tags": [ "widget", "status", "utility" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/preload-status/preload-status.metadata.ts", "exportName": "PDX_PRELOAD_STATUS_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-preload-status\nSelector: pdx-preload-status\nFriendly Name: Status de preload\nDescription: Indicador de carregamento/estado para formulários/listas.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, status, utility\nInputs:\n - metadata (any)\n - visible (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/preload-status/preload-status.metadata.ts", "contentHash": "1141130fb237a8edddcec42980d9017e11a20b0a22e4305a71098c2ba6e56d3a", "sourceKind": "component_definition", "sourceId": "pdx-preload-status", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"display-action\",\n \"title\": \"Display and action controls\",\n \"description\": \"Profile for non-data or action-like field controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-button\",\n \"pdx-preload-status\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Display/action metadata paths such as label, icon, action id, loading state and presentation mode.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.displayAction.configure\",\n \"title\": \"Configure display/action field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"actionId\": {\n \"type\": \"string\"\n },\n \"presentationOnly\": {\n \"type\": \"boolean\"\n },\n \"loadingStatePath\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"display-action-contract-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.label\",\n \"fieldMetadata.icon\",\n \"fieldMetadata.actionId\",\n \"fieldMetadata.presentationOnly\",\n \"fieldMetadata.loadingStatePath\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"display-action-contract-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP018\",\n \"description\": \"Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-action-button\",\n \"request\": \"Configure a button field to trigger the refresh action.\",\n \"operationId\": \"field.displayAction.configure\",\n \"params\": {\n \"label\": \"Refresh\",\n \"icon\": \"refresh\",\n \"actionId\": \"refresh\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "573fbd371267ad9aa74be8f69f9957c57b072396f3e438bdf61a4d7250cd1928", "sourceKind": "component_definition", "sourceId": "pdx-preload-status", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-preload-status | utility preload widget\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-preload-status\",\n \"tags\": [\n \"dynamic-fields\",\n \"status\",\n \"utility\"\n ],\n \"useWhen\": \"mostrar status de preload\",\n \"examplePrompts\": [\n \"mostrar status de preload\",\n \"adicione um status de preload no layout\"\n ]\n },\n \"metadata\": {\n \"example\": true\n },\n \"visible\": true\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-preload-status.json", "contentHash": "e2be8b196e33662ee94855b9a5935528723453822a41bdf6b049183f1ca79fde", "sourceKind": "component_definition", "sourceId": "pdx-preload-status", "corpusVersion": "1.0.0" } ] }, "pdx-search-input": { "id": "pdx-search-input", "description": "Campo de busca com ícone e atalhos.", "inputs": [ { "name": "metadata", "type": "MaterialSearchInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-search-input", "friendlyName": "Busca (input)", "icon": "search", "tags": [ "widget", "field", "input", "search", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/search-input/search-input.metadata.ts", "exportName": "PDX_SEARCH_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-search-input\nSelector: pdx-search-input\nFriendly Name: Busca (input)\nDescription: Campo de busca com ícone e atalhos.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, search, material\nInputs:\n - metadata (MaterialSearchInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/search-input/search-input.metadata.ts", "contentHash": "4781ec869e9a93f32d6f511d74e09c647c2c98c15a521dc2c0ad2f969efb2726", "sourceKind": "component_definition", "sourceId": "pdx-search-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"text-input\",\n \"title\": \"Text input controls\",\n \"description\": \"Profile for text-like controls, including inline and Material text inputs.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-email-input\",\n \"pdx-inline-input\",\n \"pdx-inline-phone\",\n \"pdx-material-textarea\",\n \"pdx-password-input\",\n \"pdx-phone-input\",\n \"pdx-search-input\",\n \"pdx-text-input\",\n \"pdx-url-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.text.configure\",\n \"title\": \"Configure text field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"placeholder\": {\n \"type\": \"string\"\n },\n \"minLength\": {\n \"type\": \"number\"\n },\n \"maxLength\": {\n \"type\": \"number\"\n },\n \"pattern\": {\n \"type\": \"string\"\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"autocomplete\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"text-metadata-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.placeholder\",\n \"fieldMetadata.minLength\",\n \"fieldMetadata.maxLength\",\n \"fieldMetadata.pattern\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.autocomplete\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"text-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP001\",\n \"description\": \"Text constraints must preserve string field semantics and editor/runtime round-trip.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-text-placeholder-and-length\",\n \"request\": \"Set placeholder and maximum length for a text input.\",\n \"operationId\": \"field.text.configure\",\n \"params\": {\n \"placeholder\": \"Search by name\",\n \"maxLength\": 120\n },\n \"isPositive\": true\n }\n ],\n \"roundTripRequirements\": [\n \"Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state.\"\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "c0029e40a022738aabac65b76da38df2467c0f2c2e2e743baebc4841554e762b", "sourceKind": "component_definition", "sourceId": "pdx-search-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-search-input | controlType: search\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-search-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo search\",\n \"examplePrompts\": [\n \"crie um campo search\",\n \"adicione um search ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_search\",\n \"label\": \"Example search\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"search\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"search\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-search-input.json", "contentHash": "ff73f42cdfa1a84f64d29131c7d2db2578da5616edd3e565c6373d1a8472261c", "sourceKind": "component_definition", "sourceId": "pdx-search-input", "corpusVersion": "1.0.0" } ] }, "pdx-text-input": { "id": "pdx-text-input", "description": "praxis.dynamicFields.editorial.textInput.description", "inputs": [ { "name": "metadata", "type": "MaterialInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-text-input", "friendlyName": "praxis.dynamicFields.editorial.textInput.friendlyName", "icon": "text_fields", "tags": [ "widget", "field", "input", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/text-input/text-input.metadata.ts", "exportName": "PDX_TEXT_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-text-input\nSelector: pdx-text-input\nFriendly Name: praxis.dynamicFields.editorial.textInput.friendlyName\nDescription: praxis.dynamicFields.editorial.textInput.description\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, material\nInputs:\n - metadata (MaterialInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/text-input/text-input.metadata.ts", "contentHash": "234bf02f596c7ffb7d2bafe9fcf797be0779ac27957953604a03c6147f02af9a", "sourceKind": "component_definition", "sourceId": "pdx-text-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"text-input\",\n \"title\": \"Text input controls\",\n \"description\": \"Profile for text-like controls, including inline and Material text inputs.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-email-input\",\n \"pdx-inline-input\",\n \"pdx-inline-phone\",\n \"pdx-material-textarea\",\n \"pdx-password-input\",\n \"pdx-phone-input\",\n \"pdx-search-input\",\n \"pdx-text-input\",\n \"pdx-url-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.text.configure\",\n \"title\": \"Configure text field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"placeholder\": {\n \"type\": \"string\"\n },\n \"minLength\": {\n \"type\": \"number\"\n },\n \"maxLength\": {\n \"type\": \"number\"\n },\n \"pattern\": {\n \"type\": \"string\"\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"autocomplete\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"text-metadata-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.placeholder\",\n \"fieldMetadata.minLength\",\n \"fieldMetadata.maxLength\",\n \"fieldMetadata.pattern\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.autocomplete\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"text-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP001\",\n \"description\": \"Text constraints must preserve string field semantics and editor/runtime round-trip.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-text-placeholder-and-length\",\n \"request\": \"Set placeholder and maximum length for a text input.\",\n \"operationId\": \"field.text.configure\",\n \"params\": {\n \"placeholder\": \"Search by name\",\n \"maxLength\": 120\n },\n \"isPositive\": true\n }\n ],\n \"roundTripRequirements\": [\n \"Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state.\"\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "c0029e40a022738aabac65b76da38df2467c0f2c2e2e743baebc4841554e762b", "sourceKind": "component_definition", "sourceId": "pdx-text-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-text-input | controlType: input\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-text-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo input\",\n \"examplePrompts\": [\n \"crie um campo input\",\n \"adicione um input ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_input\",\n \"label\": \"Example input\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"input\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"text\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-text-input.json", "contentHash": "08f6542564caf9493e0165f24966348abc927023483718ec94f5735c91e3f11a", "sourceKind": "component_definition", "sourceId": "pdx-text-input", "corpusVersion": "1.0.0" } ] }, "pdx-time-input": { "id": "pdx-time-input", "description": "Campo de hora (HH:mm) com validação.", "inputs": [ { "name": "metadata", "type": "MaterialTimeInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-time-input", "friendlyName": "Hora (input)", "icon": "schedule", "tags": [ "widget", "field", "input", "time", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/time-input/time-input.metadata.ts", "exportName": "PDX_TIME_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-time-input\nSelector: pdx-time-input\nFriendly Name: Hora (input)\nDescription: Campo de hora (HH:mm) com validação.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, time, material\nInputs:\n - metadata (MaterialTimeInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/time-input/time-input.metadata.ts", "contentHash": "cc67121821c2f74690761d7616644b2180b0df33de3240bb7cb8e9053add7a7a", "sourceKind": "component_definition", "sourceId": "pdx-time-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date\",\n \"title\": \"Date controls\",\n \"description\": \"Profile for single date, datetime, month, week, year and time picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-date-input\",\n \"pdx-datetime-local-input\",\n \"pdx-inline-date\",\n \"pdx-inline-time\",\n \"pdx-material-datepicker\",\n \"pdx-material-timepicker\",\n \"pdx-month-input\",\n \"pdx-time-input\",\n \"pdx-week-input\",\n \"pdx-year-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date/time metadata paths such as min, max, timezone, locale and format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.date.configure\",\n \"title\": \"Configure date or time field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"timezone\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"temporal-bounds-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.timezone\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.format\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-min-max\",\n \"request\": \"Limit the date field to the current year in Sao Paulo timezone.\",\n \"operationId\": \"field.date.configure\",\n \"params\": {\n \"min\": \"2026-01-01\",\n \"max\": \"2026-12-31\",\n \"timezone\": \"America/Sao_Paulo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "08eab5ad75f996b139ebddd730883a5cd6895567e2c3a16cafc4ddf60e53b185", "sourceKind": "component_definition", "sourceId": "pdx-time-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-time-input | controlType: time | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-time-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"time\"\n ],\n \"useWhen\": \"capturar horário pontual sem sobrecarga de UI\",\n \"examplePrompts\": [\n \"crie um campo time para horário de início\",\n \"adicione time para corte operacional\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"startTime\",\n \"label\": \"Horário de início\",\n \"placeholder\": \"HH:mm\",\n \"controlType\": \"time\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de horário de início\"\n },\n \"stepMinute\": 15,\n \"ariaLabel\": \"Campo de horário de início\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-time-input.json", "contentHash": "6c937c703eb538c3ddf317ea3ed11408d5584fc34214c363462c7bc6d3e8b1a5", "sourceKind": "component_definition", "sourceId": "pdx-time-input", "corpusVersion": "1.0.0" } ] }, "pdx-url-input": { "id": "pdx-url-input", "description": "Campo de URL com validação.", "inputs": [ { "name": "metadata", "type": "MaterialUrlInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-url-input", "friendlyName": "URL (input)", "icon": "link", "tags": [ "widget", "field", "input", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/url-input/url-input.metadata.ts", "exportName": "PDX_URL_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-url-input\nSelector: pdx-url-input\nFriendly Name: URL (input)\nDescription: Campo de URL com validação.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, material\nInputs:\n - metadata (MaterialUrlInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/url-input/url-input.metadata.ts", "contentHash": "b5ff02a0015bed66e41831ff6ccf42c2958ca3b938c36979453097f7de75c7ea", "sourceKind": "component_definition", "sourceId": "pdx-url-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"text-input\",\n \"title\": \"Text input controls\",\n \"description\": \"Profile for text-like controls, including inline and Material text inputs.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-email-input\",\n \"pdx-inline-input\",\n \"pdx-inline-phone\",\n \"pdx-material-textarea\",\n \"pdx-password-input\",\n \"pdx-phone-input\",\n \"pdx-search-input\",\n \"pdx-text-input\",\n \"pdx-url-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.text.configure\",\n \"title\": \"Configure text field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"placeholder\": {\n \"type\": \"string\"\n },\n \"minLength\": {\n \"type\": \"number\"\n },\n \"maxLength\": {\n \"type\": \"number\"\n },\n \"pattern\": {\n \"type\": \"string\"\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"autocomplete\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"text-metadata-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.placeholder\",\n \"fieldMetadata.minLength\",\n \"fieldMetadata.maxLength\",\n \"fieldMetadata.pattern\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.autocomplete\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"text-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP001\",\n \"description\": \"Text constraints must preserve string field semantics and editor/runtime round-trip.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-text-placeholder-and-length\",\n \"request\": \"Set placeholder and maximum length for a text input.\",\n \"operationId\": \"field.text.configure\",\n \"params\": {\n \"placeholder\": \"Search by name\",\n \"maxLength\": 120\n },\n \"isPositive\": true\n }\n ],\n \"roundTripRequirements\": [\n \"Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state.\"\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "c0029e40a022738aabac65b76da38df2467c0f2c2e2e743baebc4841554e762b", "sourceKind": "component_definition", "sourceId": "pdx-url-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-url-input | controlType: url\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-url-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo url\",\n \"examplePrompts\": [\n \"crie um campo url\",\n \"adicione um url ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_url\",\n \"label\": \"Example url\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"url\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"url\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-url-input.json", "contentHash": "283ec023952a0427369a9893c71075189c2ae4c868e42c285d63a0ce3c474aa6", "sourceKind": "component_definition", "sourceId": "pdx-url-input", "corpusVersion": "1.0.0" } ] }, "pdx-week-input": { "id": "pdx-week-input", "description": "Campo de semana com validação.", "inputs": [ { "name": "metadata", "type": "MaterialWeekInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [ { "name": "validationChange", "type": "ValidationErrors | null", "required": false } ], "configSchemaId": null, "selector": "pdx-week-input", "friendlyName": "Semana (input)", "icon": "event", "tags": [ "widget", "field", "input", "material", "date" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/week-input/week-input.metadata.ts", "exportName": "PDX_WEEK_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-week-input\nSelector: pdx-week-input\nFriendly Name: Semana (input)\nDescription: Campo de semana com validação.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, material, date\nInputs:\n - metadata (MaterialWeekInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\nOutputs:\n - validationChange (ValidationErrors | null)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/week-input/week-input.metadata.ts", "contentHash": "c897ace0b1a936b3fce0abbb44bd8b6a7360b355706b72c6ba7068498b9c286d", "sourceKind": "component_definition", "sourceId": "pdx-week-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date\",\n \"title\": \"Date controls\",\n \"description\": \"Profile for single date, datetime, month, week, year and time picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-date-input\",\n \"pdx-datetime-local-input\",\n \"pdx-inline-date\",\n \"pdx-inline-time\",\n \"pdx-material-datepicker\",\n \"pdx-material-timepicker\",\n \"pdx-month-input\",\n \"pdx-time-input\",\n \"pdx-week-input\",\n \"pdx-year-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date/time metadata paths such as min, max, timezone, locale and format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.date.configure\",\n \"title\": \"Configure date or time field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"timezone\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"temporal-bounds-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.timezone\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.format\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-min-max\",\n \"request\": \"Limit the date field to the current year in Sao Paulo timezone.\",\n \"operationId\": \"field.date.configure\",\n \"params\": {\n \"min\": \"2026-01-01\",\n \"max\": \"2026-12-31\",\n \"timezone\": \"America/Sao_Paulo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "08eab5ad75f996b139ebddd730883a5cd6895567e2c3a16cafc4ddf60e53b185", "sourceKind": "component_definition", "sourceId": "pdx-week-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-week-input | controlType: week | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-week-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"week\"\n ],\n \"useWhen\": \"organizar planejamento por semana operacional\",\n \"examplePrompts\": [\n \"crie um campo week para sprint\",\n \"adicione week para planejamento semanal\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"sprintWeek\",\n \"label\": \"Semana\",\n \"placeholder\": \"aaaa-Www\",\n \"controlType\": \"week\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de semana\"\n },\n \"ariaLabel\": \"Campo de semana operacional\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-week-input.json", "contentHash": "996624f6da91b01243926290d7b51a2f99f4922d52f36f5af51d7b2ebbd26cd4", "sourceKind": "component_definition", "sourceId": "pdx-week-input", "corpusVersion": "1.0.0" } ] }, "pdx-year-input": { "id": "pdx-year-input", "description": "Campo para seleção de ano com validação.", "inputs": [ { "name": "metadata", "type": "MaterialYearInputMetadata", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": null, "selector": "pdx-year-input", "friendlyName": "Ano (input)", "icon": "calendar_month", "tags": [ "widget", "field", "input", "date", "material" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/pdx-year-input/pdx-year-input.metadata.ts", "exportName": "PDX_YEAR_INPUT_COMPONENT_METADATA", "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: pdx-year-input\nSelector: pdx-year-input\nFriendly Name: Ano (input)\nDescription: Campo para seleção de ano com validação.\nLib/Package: @praxisui/dynamic-fields\nTags: widget, field, input, date, material\nInputs:\n - metadata (MaterialYearInputMetadata)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/pdx-year-input/pdx-year-input.metadata.ts", "contentHash": "b6d7f8cec0ca77ff446b3c9e96f16b4fea2b0d53cd4bdc5d2d7ce2a34a1eb72b", "sourceKind": "component_definition", "sourceId": "pdx-year-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"date\",\n \"title\": \"Date controls\",\n \"description\": \"Profile for single date, datetime, month, week, year and time picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-date-input\",\n \"pdx-datetime-local-input\",\n \"pdx-inline-date\",\n \"pdx-inline-time\",\n \"pdx-material-datepicker\",\n \"pdx-material-timepicker\",\n \"pdx-month-input\",\n \"pdx-time-input\",\n \"pdx-week-input\",\n \"pdx-year-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date/time metadata paths such as min, max, timezone, locale and format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.date.configure\",\n \"title\": \"Configure date or time field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"timezone\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"temporal-bounds-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.timezone\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.format\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-min-max\",\n \"request\": \"Limit the date field to the current year in Sao Paulo timezone.\",\n \"operationId\": \"field.date.configure\",\n \"params\": {\n \"min\": \"2026-01-01\",\n \"max\": \"2026-12-31\",\n \"timezone\": \"America/Sao_Paulo\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "08eab5ad75f996b139ebddd730883a5cd6895567e2c3a16cafc4ddf60e53b185", "sourceKind": "component_definition", "sourceId": "pdx-year-input", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-year-input | controlType: year | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-year-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"year\"\n ],\n \"useWhen\": \"informar ano de referência fiscal ou orçamento\",\n \"examplePrompts\": [\n \"crie um campo year para ano fiscal\",\n \"adicione year para ano de vigência\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"fiscalYear\",\n \"label\": \"Ano fiscal\",\n \"placeholder\": \"AAAA\",\n \"controlType\": \"year\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de ano fiscal\"\n },\n \"min\": 2020,\n \"max\": 2035,\n \"ariaLabel\": \"Campo de ano fiscal\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-year-input.json", "contentHash": "cea4a442e0c529601b28921c1af856c03cc35a852d49e4e35edca2d88389ad2b", "sourceKind": "component_definition", "sourceId": "pdx-year-input", "corpusVersion": "1.0.0" } ] }, "praxis-dynamic-fields": { "id": "praxis-dynamic-fields", "description": "Family-level registry entry for @praxisui/dynamic-fields control authoring across package-owned field components.", "category": "form", "inputs": [], "outputs": [], "configSchemaId": "FieldMetadata", "selector": "praxis-dynamic-fields", "friendlyName": "Praxis Dynamic Fields", "icon": "dynamic_form", "tags": [ "dynamic-fields", "field-metadata", "authoring", "component-family" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "exportName": "PRAXIS_DYNAMIC_FIELDS_AUTHORING_MANIFEST", "componentFamily": true, "projectedComponentCount": 75, "projectedComponentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-date-input", "pdx-datetime-local-input", "pdx-editable-collection", "pdx-email-input", "pdx-entity-lookup", "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-currency", "pdx-inline-currency-range", "pdx-inline-date", "pdx-inline-date-range", "pdx-inline-distance-radius", "pdx-inline-input", "pdx-inline-month-range", "pdx-inline-multi-select", "pdx-inline-number", "pdx-inline-period-range", "pdx-inline-phone", "pdx-inline-pipeline-status", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-relative-period", "pdx-inline-score-priority", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-inline-time", "pdx-inline-time-range", "pdx-inline-toggle", "pdx-inline-tree-select", "pdx-inline-year-range", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-avatar", "pdx-material-button", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-colorpicker", "pdx-material-cpf-cnpj-input", "pdx-material-currency", "pdx-material-date-range", "pdx-material-datepicker", "pdx-material-file-upload", "pdx-material-multi-select", "pdx-material-multi-select-tree", "pdx-material-price-range", "pdx-material-radio-group", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-searchable-select", "pdx-material-select", "pdx-material-selection-list", "pdx-material-slide-toggle", "pdx-material-slider", "pdx-material-textarea", "pdx-material-time-range", "pdx-material-timepicker", "pdx-material-transfer-list", "pdx-material-tree-select", "pdx-month-input", "pdx-number-input", "pdx-password-input", "pdx-phone-input", "pdx-preload-status", "pdx-search-input", "pdx-text-input", "pdx-time-input", "pdx-url-input", "pdx-week-input", "pdx-year-input", "praxis-field-shell" ], "capabilities": [ { "path": "id", "category": "identity", "valueKind": "string", "description": "Identificador unico da instancia do componente.", "intentExamples": [ "id do componente", "definir id fixo" ] }, { "path": "version", "category": "identity", "valueKind": "string", "description": "Versao do schema de metadata (migracao).", "intentExamples": [ "versao do metadata", "ajustar versao" ] }, { "path": "context", "category": "identity", "valueKind": "enum", "allowedValues": [ "form", "filter", "table", "dialog", "standalone" ], "description": "Contexto de uso do componente (form/filter/table/dialog/standalone).", "intentExamples": [ "contexto form", "usar em tabela" ] }, { "path": "createdAt", "category": "misc", "valueKind": "string", "description": "Timestamp de criacao (ISO).", "safetyNotes": "Valor de auditoria; preferir preenchimento pelo host." }, { "path": "updatedAt", "category": "misc", "valueKind": "string", "description": "Timestamp de atualizacao (ISO).", "safetyNotes": "Valor de auditoria; preferir preenchimento pelo host." }, { "path": "tags", "category": "identity", "valueKind": "array", "description": "Tags para categorizacao e busca.", "intentExamples": [ "tag para busca", "categorizar campo" ] }, { "path": "cssClass", "category": "appearance", "valueKind": "string", "description": "Classe CSS aplicada ao host do componente.", "intentExamples": [ "classe custom", "aplicar classe" ] }, { "path": "style", "category": "appearance", "valueKind": "object", "description": "Estilos inline (objeto CSS).", "safetyNotes": "Validar chaves e valores CSS permitidos." }, { "path": "dataAttributes", "category": "data", "valueKind": "object", "description": "Data attributes para teste/analytics.", "intentExamples": [ "data-testid", "atributos de tracking" ] }, { "path": "name", "category": "identity", "valueKind": "string", "description": "Identificador único do campo. Essencial para binding.", "critical": true, "intentExamples": [ "nomear campo como email", "id do campo" ] }, { "path": "label", "category": "identity", "valueKind": "string", "description": "Rótulo principal exibido para o usuário.", "intentExamples": [ "alterar label", "mudar texto do rótulo" ] }, { "path": "placeholder", "category": "identity", "valueKind": "string", "description": "Texto temporário exibido quando vazio.", "intentExamples": [ "adicionar placeholder", "texto de ajuda no input" ] }, { "path": "hint", "category": "identity", "valueKind": "string", "description": "Texto de ajuda exibido abaixo do campo.", "intentExamples": [ "colocar dica", "ajuda no rodapé do campo" ] }, { "path": "helpText", "category": "identity", "valueKind": "string", "description": "Texto semântico de ajuda publicado pelo schema/DTO.", "intentExamples": [ "explicar regra de negócio do campo", "ajuda vinda do backend" ] }, { "path": "tooltip", "category": "identity", "valueKind": "string", "description": "Texto exibido ao passar o mouse.", "intentExamples": [ "adicionar tooltip" ] }, { "path": "tooltipOnHover", "category": "identity", "valueKind": "boolean", "description": "Habilita apresentação do tooltip no hover quando suportado pelo renderer.", "intentExamples": [ "mostrar tooltip ao passar o mouse", "ativar dica no hover" ] }, { "path": "description", "category": "identity", "valueKind": "string", "description": "Descrição detalhada (usada em documentação ou helps extensos).", "intentExamples": [ "descrição completa do campo", "texto explicativo longo", "documentação do input" ] }, { "path": "selectionMode", "category": "behavior", "valueKind": "enum", "allowedValues": [ "boolean", "single", "multiple" ], "description": "Semântica de seleção explícita para controles de escolha.", "intentExamples": [ "checkbox booleano", "radio de escolha única", "grupo múltiplo" ] }, { "path": "variant", "category": "appearance", "valueKind": "string", "description": "Variante visual/semântica do controle.", "intentExamples": [ "variante consent", "modo compact", "apresentação em tiles" ] }, { "path": "density", "category": "appearance", "valueKind": "enum", "allowedValues": [ "compact", "comfortable", "spacious" ], "description": "Densidade visual do shell do controle.", "intentExamples": [ "deixar mais compacto", "usar densidade confortável", "mais espaçado" ] }, { "path": "links", "category": "identity", "valueKind": "array", "description": "Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.", "intentExamples": [ "adicionar link da política", "incluir termos de uso", "anexar link institucional" ] }, { "path": "group", "category": "identity", "valueKind": "string", "description": "Agrupador lógico do campo.", "intentExamples": [ "agrupar em Dados Pessoais", "colocar no grupo de endereço", "categoria do campo" ] }, { "path": "order", "category": "layout", "valueKind": "number", "description": "Ordem de exibição do campo.", "intentExamples": [ "mover para o final", "reordenar campo", "exibir primeiro", "posição 3" ] }, { "path": "width", "category": "layout", "valueKind": "string", "description": "Largura do campo (ex: 50%, 100px).", "intentExamples": [ "campo meia largura", "largura fixa 200px", "ocupar 50%", "width total" ] }, { "path": "isFlex", "category": "layout", "valueKind": "boolean", "description": "Se true, usa flex-grow para preencher espaço.", "intentExamples": [ "preencher espaço sobrando", "campo flexível", "expandir para caber" ] }, { "path": "controlType", "category": "behavior", "valueKind": "enum", "description": "Tipo do componente de UI (input, select, datepicker, etc).", "critical": true, "safetyNotes": "Mudar controlType pode invalidar propriedades específicas do componente anterior. Aplique o overlay de microcomponente correspondente.", "intentExamples": [ "mudar para select", "usar datepicker", "transformar em checkbox", "tipo do controle" ] }, { "path": "dataType", "category": "data", "valueKind": "enum", "description": "Tipo de dado do campo (text, number, date, etc).", "intentExamples": [ "tipo de dado numero", "campo de data" ] }, { "path": "source", "category": "data", "valueKind": "enum", "allowedValues": [ "schema", "local" ], "description": "Origem semântica do campo. Use local para campos do host que não vêm do schema backend.", "intentExamples": [ "campo local", "campo auxiliar do host", "campo que não vem do schema" ], "safetyNotes": "Não marque como local um campo que exista no schema backend; remova a semântica local quando houver colisão com campo server-backed." }, { "path": "transient", "category": "data", "valueKind": "boolean", "description": "Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.", "intentExamples": [ "campo temporário", "campo transient", "não enviar no payload", "usar apenas na UI" ], "safetyNotes": "Campos transient continuam participando de UI, validação, regras, visibilidade e valueChange; eles apenas saem do payload persistido por padrão." }, { "path": "submitPolicy", "category": "behavior", "valueKind": "enum", "allowedValues": [ "include", "omit", "includeWhenDirty" ], "description": "Política de submit para sobrescrever o padrão de campos locais/transient.", "intentExamples": [ "omitir do submit", "enviar mesmo sendo local", "enviar apenas se alterado" ], "safetyNotes": "Use omit para nunca persistir, include para enviar sempre e includeWhenDirty apenas quando o controle estiver dirty." }, { "path": "materialDesign.appearance", "category": "appearance", "valueKind": "enum", "allowedValues": [ "fill", "outline" ], "description": "Aparência do campo Material (fill/outline).", "intentExamples": [ "estilo outline", "aparência preenchida", "campo com borda" ] }, { "path": "materialDesign.color", "category": "appearance", "valueKind": "enum", "allowedValues": [ "primary", "accent", "warn" ], "description": "Tema de cor Material (primary/accent/warn).", "intentExamples": [ "cor primária", "destacar com accent" ] }, { "path": "materialDesign.floatLabel", "category": "appearance", "valueKind": "enum", "allowedValues": [ "auto", "always", "never" ], "description": "Comportamento do rótulo flutuante.", "intentExamples": [ "label sempre flutuando", "nunca flutuar label" ] }, { "path": "materialDesign.subscriptSizing", "category": "appearance", "valueKind": "enum", "allowedValues": [ "fixed", "dynamic" ], "description": "Estratégia de sizing do subscript (erros/hints)." }, { "path": "materialDesign.hideRequiredMarker", "category": "appearance", "valueKind": "boolean", "description": "Oculta o asterisco de campo obrigatório." }, { "path": "materialDesign.density", "category": "appearance", "valueKind": "enum", "allowedValues": [ "comfortable", "compact", "dense" ], "description": "Densidade do campo Material." }, { "path": "materialDesign.disableRipple", "category": "appearance", "valueKind": "boolean", "description": "Desativa ripple/ondulação em componentes Material." }, { "path": "materialDesign.customPalette", "category": "appearance", "valueKind": "object", "description": "Override de paleta (primary/accent/warn).", "safetyNotes": "Use cores válidas; validar contra o tema." }, { "path": "materialDesign.animations", "category": "appearance", "valueKind": "object", "description": "Configuração de animações (disable, duration, easing)." }, { "path": "prefixIcon", "category": "appearance", "valueKind": "string", "description": "Ícone exibido antes do valor.", "intentExamples": [ "ícone de usuário no início", "prefixar ícone", "imagem antes do texto" ] }, { "path": "suffixIcon", "category": "appearance", "valueKind": "string", "description": "Ícone exibido depois do valor.", "intentExamples": [ "ícone de busca no final", "sufixar ícone", "botão de ação no fim" ] }, { "path": "iconPosition", "category": "appearance", "valueKind": "enum", "allowedValues": [ "start", "end" ], "description": "Posição preferencial do ícone principal.", "intentExamples": [ "ícone à esquerda", "posicionar ícone no fim" ] }, { "path": "iconSize", "category": "appearance", "valueKind": "enum", "allowedValues": [ "small", "medium", "large" ], "description": "Tamanho do ícone.", "intentExamples": [ "ícone pequeno", "aumentar tamanho do ícone", "ícone grande" ] }, { "path": "iconColor", "category": "appearance", "valueKind": "string", "description": "Cor semântica ou token de cor aplicado ao ícone principal.", "intentExamples": [ "ícone em cor primária", "usar token do tema no ícone" ] }, { "path": "iconClass", "category": "appearance", "valueKind": "string", "description": "Classe CSS controlada pelo host para o ícone principal.", "intentExamples": [ "usar classe de ícone outlined", "aplicar classe corporativa" ] }, { "path": "iconStyle", "category": "appearance", "valueKind": "string", "description": "Estilo visual semântico do ícone quando o renderer suportar variações.", "intentExamples": [ "usar ícone arredondado", "aplicar estilo filled" ] }, { "path": "iconFontSize", "category": "appearance", "valueKind": "string", "description": "Tamanho tipográfico do ícone principal.", "intentExamples": [ "ícone com 18px", "ajustar tamanho do ícone" ] }, { "path": "valuePresentation", "category": "appearance", "valueKind": "object", "description": "Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.", "safetyNotes": "Preferir este contrato a formatadores legados quando a intencao for apresentacao de valor.", "intentExamples": [ "mostrar como moeda", "formatar como data longa", "exibir percentual" ] }, { "path": "presentation", "category": "appearance", "valueKind": "object", "description": "Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.", "safetyNotes": "Use apenas semantica declarativa; nao incluir CSS arbitrario, HTML, comandos ou efeitos mutaveis.", "intentExamples": [ "status com icone", "badge de pendente", "campo em tom warning" ] }, { "path": "presentation.presenter", "category": "appearance", "valueKind": "enum", "allowedValues": [ "text", "badge", "chip", "status", "iconValue", "progress", "rating", "microVisualization" ], "description": "Tipo semantico de renderizacao em modo apresentacao.", "intentExamples": [ "renderizar como status", "usar chip", "mostrar icone com valor" ] }, { "path": "presentation.tone", "category": "appearance", "valueKind": "enum", "allowedValues": [ "neutral", "info", "success", "warning", "danger" ], "description": "Tom semantico mapeado pelo consumidor para tokens de tema.", "intentExamples": [ "tom de sucesso", "tom de alerta", "tom de erro" ] }, { "path": "presentation.appearance", "category": "appearance", "valueKind": "enum", "allowedValues": [ "plain", "soft", "outlined", "filled" ], "description": "Nivel de enfase visual do apresentador.", "intentExamples": [ "status preenchido", "badge contornado", "chip suave" ] }, { "path": "presentation.icon", "category": "appearance", "valueKind": "string", "description": "Nome de icone Material Symbols usado pelo apresentador semantico.", "intentExamples": [ "icone lock", "icone payments", "icone schedule" ] }, { "path": "presentation.label", "category": "identity", "valueKind": "string", "description": "Rotulo semantico exibido por apresentadores como status, badge ou chip.", "intentExamples": [ "rotulo Bloqueado", "texto Aprovado", "status Aguardando aprovacao" ] }, { "path": "presentation.badge", "category": "appearance", "valueKind": "string", "description": "Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.", "intentExamples": [ "badge alto valor", "marcador D+35", "sinalizar revisao executiva" ] }, { "path": "presentation.valuePresentation", "category": "appearance", "valueKind": "object", "description": "Override de formatacao aplicado apenas pela superficie de apresentacao.", "safetyNotes": "Nao altera o valor real do FormControl nem o payload de submit." }, { "path": "presentation.visualization", "category": "appearance", "valueKind": "object", "description": "Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.", "safetyNotes": "Exige fallback textual e nao pode conter opcoes de ECharts, HTML, SVG bruto, CSS ou comandos.", "intentExamples": [ "micro chart de SLA", "barra empilhada em celula", "bullet chart de orcamento", "fluxo compacto de aprovacao" ] }, { "path": "presentation.visualization.kind", "category": "appearance", "valueKind": "enum", "allowedValues": [ "line", "area", "column", "comparison", "stackedBar", "radial", "harveyBall", "bullet", "delta", "processFlow" ], "description": "Tipo semantico da micro visualizacao de apresentacao.", "intentExamples": [ "comparison", "stackedBar", "bullet", "processFlow" ] }, { "path": "presentation.visualization.surface", "category": "layout", "valueKind": "enum", "allowedValues": [ "table-cell", "list-item", "object-header", "card-summary", "form-presentation" ], "description": "Superficie alvo usada para aplicar regras de densidade e fallback.", "intentExamples": [ "table-cell", "list-item", "form-presentation" ] }, { "path": "presentation.visualization.size", "category": "layout", "valueKind": "enum", "allowedValues": [ "xs", "sm", "md", "lg", "responsive" ], "description": "Tamanho semantico da micro visualizacao.", "intentExamples": [ "xs em tabela", "md em header", "responsive em card" ] }, { "path": "presentation.visualization.fallbackText", "category": "accessibility", "valueKind": "string", "description": "Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.", "safetyNotes": "Deve explicar valor, unidade, meta, tendencia ou estado quando aplicavel." }, { "path": "presentationRules", "category": "appearance", "valueKind": "array", "description": "Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.", "safetyNotes": "As regras devem produzir apenas set/effect semantico. Nao use para alterar valor, executar acao, navegar ou injetar HTML/CSS.", "intentExamples": [ "se status for BLOQUEADO, usar tone danger", "se valor maior que limite, mostrar badge de revisao" ] }, { "path": "presentationRules[].when", "category": "behavior", "valueKind": "object", "description": "Guarda Json Logic avaliada contra o contexto de apresentacao do campo.", "safetyNotes": "Use Json Logic serializavel; funcoes nao sao aceitas." }, { "path": "presentationRules[].set", "category": "appearance", "valueKind": "object", "description": "Patch semantico aplicado sobre presentation quando a guarda for verdadeira.", "safetyNotes": "Somente presenter, tone, icon, label, badge, tooltip, appearance, valuePresentation e interactions seguras." }, { "path": "mask", "category": "appearance", "valueKind": "string", "description": "Máscara de input (padrão do componente).", "intentExamples": [ "máscara de CPF", "formatar telefone", "aplicar máscara de data", "pattern visual" ] }, { "path": "format", "category": "appearance", "valueKind": "string", "description": "Formato de exibição (ex: pipes).", "intentExamples": [ "formato de data dd/mm/yyyy", "formato de moeda", "exibir como porcentagem" ] }, { "path": "validators", "category": "validation", "valueKind": "object", "description": "Objeto contendo todas as regras de validação.", "safetyNotes": "Não sobrescreva este objeto inteiramente; faça merge das propriedades.", "intentExamples": [ "adicionar validações", "regras de validação", "objeto validators" ] }, { "path": "validators.required", "category": "validation", "valueKind": "boolean", "description": "Campo obrigatório.", "intentExamples": [ "tornar obrigatório", "campo mandatório", "exigir preenchimento", "remover required" ] }, { "path": "required", "category": "validation", "valueKind": "boolean", "description": "Campo obrigatório (alias rápido do validators.required).", "intentExamples": [ "campo obrigatório", "exigir preenchimento" ] }, { "path": "validators.requiredMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para required." }, { "path": "validators.email", "category": "validation", "valueKind": "boolean", "description": "Validação de formato de e-mail.", "intentExamples": [ "validar como email", "aceitar apenas emails", "formato de correio eletrônico" ] }, { "path": "validators.emailMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para validação de email." }, { "path": "validators.minLength", "category": "validation", "valueKind": "number", "description": "Comprimento mínimo do texto.", "intentExamples": [ "mínimo de 5 caracteres", "pelo menos 3 letras", "tamanho mínimo" ] }, { "path": "validators.minLengthMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para minLength." }, { "path": "validators.maxLength", "category": "validation", "valueKind": "number", "description": "Comprimento máximo do texto.", "intentExamples": [ "máximo de 100 caracteres", "limitar tamanho", "não exceder 50 letras" ] }, { "path": "validators.maxLengthMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para maxLength." }, { "path": "validators.min", "category": "validation", "valueKind": "number", "description": "Valor numérico mínimo.", "intentExamples": [ "valor mínimo 10", "não aceitar menor que 0", "piso de valor" ] }, { "path": "validators.minMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para min." }, { "path": "validators.max", "category": "validation", "valueKind": "number", "description": "Valor numérico máximo.", "intentExamples": [ "valor máximo 100", "teto de valor", "não aceitar maior que 50" ] }, { "path": "validators.maxMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para max." }, { "path": "validators.pattern", "category": "validation", "valueKind": "string", "description": "Regex para validação.", "safetyNotes": "Cuidado com ReDoS em regex complexos.", "intentExamples": [ "validar com regex", "padrão customizado", "expressão regular" ] }, { "path": "validators.patternMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para pattern." }, { "path": "validators.cpf", "category": "validation", "valueKind": "boolean", "description": "Validador de CPF (legado)." }, { "path": "validators.cnpj", "category": "validation", "valueKind": "boolean", "description": "Validador de CNPJ (legado)." }, { "path": "validators.cpfCnpj", "category": "validation", "valueKind": "boolean", "description": "Validador automatico CPF/CNPJ (legado)." }, { "path": "validators.cnpjAlpha", "category": "validation", "valueKind": "boolean", "description": "Validador de CNPJ alfanumerico (legado)." }, { "path": "validators.cpfMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CPF." }, { "path": "validators.cnpjMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CNPJ." }, { "path": "validators.cnpjAlphaMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CNPJ alfanumerico." }, { "path": "validators.url", "category": "validation", "valueKind": "boolean", "description": "Validador de URL." }, { "path": "validators.urlMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para URL." }, { "path": "validators.minWords", "category": "validation", "valueKind": "number", "description": "Mínimo de palavras.", "intentExamples": [ "mínimo de 2 palavras", "exigir nome completo (2 palavras)" ] }, { "path": "validators.requiredChecked", "category": "validation", "valueKind": "boolean", "description": "Exige checkbox marcado (ex: termos de uso).", "intentExamples": [ "obrigar marcar checkbox", "aceitar termos é obrigatório" ] }, { "path": "validators.customValidator", "category": "validation", "valueKind": "expression", "description": "Validador customizado (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.asyncValidator", "category": "validation", "valueKind": "expression", "description": "Validador async customizado (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.matchField", "category": "validation", "valueKind": "string", "description": "Campo que deve coincidir (cross-field)." }, { "path": "validators.matchFieldMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para matchField." }, { "path": "validators.uniqueValidator", "category": "validation", "valueKind": "expression", "description": "Validador de unicidade via API (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.uniqueMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para unicidade." }, { "path": "validators.conditionalValidation", "category": "validation", "valueKind": "array", "description": "Regras de validação condicional.", "safetyNotes": "Use regras declarativas com Json Logic serializável; não gere funções aqui." }, { "path": "validators.conditionalValidation[].condition", "category": "validation", "valueKind": "expression", "description": "Condicao para aplicar validadores.", "safetyNotes": "Use Json Logic canônico avaliado sobre o root `form`." }, { "path": "validators.conditionalValidation[].validators", "category": "validation", "valueKind": "object", "description": "Conjunto de validadores aplicados quando a condicao for verdadeira." }, { "path": "validators.validationTrigger", "category": "validation", "valueKind": "enum", "allowedValues": [ "change", "blur", "submit", "immediate" ], "description": "Gatilho de validação no validator." }, { "path": "validators.validationDebounce", "category": "validation", "valueKind": "number", "description": "Debounce de validação no validator (ms)." }, { "path": "validators.showInlineErrors", "category": "validation", "valueKind": "boolean", "description": "Exibe erros inline (validator)." }, { "path": "validators.errorPosition", "category": "validation", "valueKind": "enum", "allowedValues": [ "bottom", "top", "tooltip" ], "description": "Posicao do erro (validator)." }, { "path": "validationMode", "category": "validation", "valueKind": "enum", "allowedValues": [ "immediate", "blur", "submit" ], "description": "Gatilho da validação (change/blur/submit).", "intentExamples": [ "validar ao sair do campo (blur)", "validar apenas no submit", "validação em tempo real" ] }, { "path": "debounceTime", "category": "validation", "valueKind": "number", "description": "Debounce para validação em ms.", "intentExamples": [ "aguardar para validar", "debounce de 500ms", "delay na validação" ] }, { "path": "options", "category": "data", "valueKind": "array", "description": "Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).", "intentExamples": [ "adicionar opções estáticas", "lista fixa de itens", "opções do select" ], "safetyNotes": "Respeite o formato esperado pelo controlType; prefira merge/append em vez de substituir o array inteiro." }, { "path": "endpoint", "category": "data", "valueKind": "string", "description": "URL para carregar opções remotas.", "intentExamples": [ "carregar do servidor", "buscar API", "endpoint de dados", "url das opções" ] }, { "path": "valueField", "category": "data", "valueKind": "string", "description": "Nome da propriedade de valor nas opções.", "intentExamples": [ "usar \"id\" como valor", "campo de valor das opções" ] }, { "path": "displayField", "category": "data", "valueKind": "string", "description": "Nome da propriedade de texto nas opções.", "intentExamples": [ "usar \"nome\" como texto", "exibir campo \"label\"", "campo de exibição" ] }, { "path": "filterField", "category": "data", "valueKind": "string", "description": "Campo para filtragem no backend.", "intentExamples": [ "filtrar por \"categoria\"", "campo de filtro na api" ] }, { "path": "queryParams", "category": "data", "valueKind": "object", "description": "Parâmetros fixos para a query do endpoint.", "intentExamples": [ "parâmetros extras na busca", "enviar tipo=ativo na query" ] }, { "path": "cacheDuration", "category": "data", "valueKind": "number", "description": "Duração do cache de dados em ms.", "intentExamples": [ "cachear por 5 minutos", "tempo de cache", "validade dos dados" ] }, { "path": "hidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta o campo globalmente.", "critical": true, "intentExamples": [ "ocultar campo", "esconder input", "campo invisível" ] }, { "path": "visibleIn", "category": "behavior", "valueKind": "array", "allowedValues": [ "form", "filter", "table", "dialog" ], "description": "Contextos onde o campo é visível.", "intentExamples": [ "mostrar apenas no filtro", "esconder na tabela", "visível só no form" ] }, { "path": "formHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas no formulário.", "intentExamples": [ "esconder no form", "invisível na edição" ] }, { "path": "tableHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas na tabela.", "intentExamples": [ "esconder na listagem", "não mostrar na tabela" ] }, { "path": "filterHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas no filtro.", "intentExamples": [ "esconder na busca", "remover do filtro" ] }, { "path": "dependencyFields", "category": "dependency", "valueKind": "array", "description": "Campos dos quais este campo depende.", "intentExamples": [ "depende de estado", "campo dependente", "cascata com outro campo" ] }, { "path": "conditionalRequired", "category": "dependency", "valueKind": "expression", "description": "Condição Json Logic para obrigatoriedade declarativa.", "safetyNotes": "Use Json Logic serializável; não gere função nem DSL textual.", "intentExamples": [ "obrigatório se outro campo for X", "condicionalmente requerido" ] }, { "path": "conditionalDisplay", "category": "dependency", "valueKind": "expression", "description": "Condição Json Logic para visibilidade declarativa.", "safetyNotes": "Use Json Logic serializável; não gere função nem DSL textual.", "intentExamples": [ "mostrar se checkbox marcado", "visibilidade condicional" ] }, { "path": "dependencyFilterMap", "category": "dependency", "valueKind": "object", "description": "Mapeamento de filtro baseado na dependência.", "intentExamples": [ "filtrar cidade por estado", "mapear valor da dependência" ] }, { "path": "dependencyValuePath", "category": "dependency", "valueKind": "string", "description": "Caminho no valor da dependência.", "intentExamples": [ "usar propriedade aninhada da dependência", "caminho do valor dependente" ] }, { "path": "dependencyMergeStrategy", "category": "dependency", "valueKind": "enum", "allowedValues": [ "replace", "merge" ], "description": "Estratégia de merge dos dados carregados.", "intentExamples": [ "substituir opções ao carregar", "mesclar resultados" ] }, { "path": "dependencyLoadOnChange", "category": "dependency", "valueKind": "enum", "allowedValues": [ "respectLoadOn", "immediate", "manual" ], "description": "Quando recarregar dependência.", "intentExamples": [ "recarregar assim que mudar", "recarregar manualmente", "carregar imediatamente" ] }, { "path": "resetOnDependentChange", "category": "dependency", "valueKind": "boolean", "description": "Zera valor se dependência mudar.", "intentExamples": [ "limpar se o pai mudar", "resetar valor na troca da dependência" ] }, { "path": "enableDependencyCascade", "category": "dependency", "valueKind": "boolean", "description": "Habilita/desabilita cascata nativa de dependências entre campos.", "intentExamples": [ "desativar cascata nativa", "habilitar cascata", "usar connections sem cascata" ] }, { "path": "dependencyDebounceMs", "category": "dependency", "valueKind": "number", "description": "Delay para reagir à mudança de dependência.", "intentExamples": [ "esperar para recarregar dependência", "debounce da cascata" ] }, { "path": "suppressInlineErrorsOnCascade", "category": "dependency", "valueKind": "boolean", "description": "Suprime erros inline durante cascata." }, { "path": "transformDisplayValue", "category": "transform", "valueKind": "expression", "description": "Transforma valor para exibição.", "safetyNotes": "Função não serializável.", "intentExamples": [ "formatar valor visualmente", "transformar display" ] }, { "path": "transformSaveValue", "category": "transform", "valueKind": "expression", "description": "Transforma valor para salvar.", "safetyNotes": "Função não serializável.", "intentExamples": [ "formatar valor para envio", "transformar payload" ] }, { "path": "textTransformApply", "category": "transform", "valueKind": "enum", "allowedValues": [ "displayOnly", "saveOnly", "both" ], "description": "Quando aplicar transformação de texto.", "intentExamples": [ "aplicar transformação apenas no display", "transformar ao salvar e exibir" ] }, { "path": "inlineEditing", "category": "behavior", "valueKind": "boolean", "description": "Permite edição inline (tabelas).", "intentExamples": [ "permitir edição na tabela", "editar na linha" ] }, { "path": "unique", "category": "validation", "valueKind": "boolean", "description": "Valida unicidade no backend.", "intentExamples": [ "validar se é único", "não permitir duplicados" ] }, { "path": "readOnly", "category": "behavior", "valueKind": "boolean", "description": "Campo somente leitura.", "intentExamples": [ "somente leitura", "bloquear edição", "campo readonly" ] }, { "path": "disabled", "category": "behavior", "valueKind": "boolean", "description": "Campo desabilitado.", "intentExamples": [ "desabilitar campo", "campo disabled", "cinza e bloqueado" ] }, { "path": "defaultValue", "category": "data", "valueKind": "object", "description": "Valor inicial do campo.", "safetyNotes": "Aceita tipos primitivos/objetos; respeite o controlType.", "intentExamples": [ "valor padrão", "iniciar com valor X", "default value" ] }, { "path": "ariaLabel", "category": "accessibility", "valueKind": "string", "description": "Label para leitores de tela.", "intentExamples": [ "label de acessibilidade", "texto para leitor de tela" ] }, { "path": "ariaDescribedBy", "category": "accessibility", "valueKind": "string", "description": "IDs de descrição acessível.", "intentExamples": [ "descrito pelo elemento X", "associar descrição aria" ] }, { "path": "tabIndex", "category": "accessibility", "valueKind": "number", "description": "Ordem de tabulacao para teclado.", "intentExamples": [ "tabindex 0", "ordem de foco" ] }, { "path": "accessKey", "category": "accessibility", "valueKind": "string", "description": "Atalho de teclado (accessKey).", "intentExamples": [ "atalho de teclado", "tecla de acesso rapido" ] } ], "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: praxis-dynamic-fields\nSelector: praxis-dynamic-fields\nFriendly Name: Praxis Dynamic Fields\nDescription: Family-level registry entry for @praxisui/dynamic-fields control authoring across package-owned field components.\nCategory: form\nLib/Package: @praxisui/dynamic-fields\nTags: dynamic-fields, field-metadata, authoring, component-family\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "8842cd1b51bfb6b63dc886668db98a759c104061bb264e0312a4e3ff9fbba099", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "capabilities", "content": "Schema Capabilities:\n - Path: id\n Category: identity\n Kind: string\n Description: Identificador unico da instancia do componente.\n - Path: version\n Category: identity\n Kind: string\n Description: Versao do schema de metadata (migracao).\n - Path: context\n Category: identity\n Kind: enum\n Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n - Path: createdAt\n Category: misc\n Kind: string\n Description: Timestamp de criacao (ISO).\n - Path: updatedAt\n Category: misc\n Kind: string\n Description: Timestamp de atualizacao (ISO).\n - Path: tags\n Category: identity\n Kind: array\n Description: Tags para categorizacao e busca.\n - Path: cssClass\n Category: appearance\n Kind: string\n Description: Classe CSS aplicada ao host do componente.\n - Path: style\n Category: appearance\n Kind: object\n Description: Estilos inline (objeto CSS).\n - Path: dataAttributes\n Category: data\n Kind: object\n Description: Data attributes para teste/analytics.\n - Path: name\n Category: identity\n Kind: string\n Description: Identificador único do campo. Essencial para binding.\n - Path: label\n Category: identity\n Kind: string\n Description: Rótulo principal exibido para o usuário.\n - Path: placeholder\n Category: identity\n Kind: string\n Description: Texto temporário exibido quando vazio.\n - Path: hint\n Category: identity\n Kind: string\n Description: Texto de ajuda exibido abaixo do campo.\n - Path: helpText\n Category: identity\n Kind: string\n Description: Texto semântico de ajuda publicado pelo schema/DTO.\n - Path: tooltip\n Category: identity\n Kind: string\n Description: Texto exibido ao passar o mouse.\n - Path: tooltipOnHover\n Category: identity\n Kind: boolean\n Description: Habilita apresentação do tooltip no hover quando suportado pelo renderer.\n - Path: description\n Category: identity\n Kind: string\n Description: Descrição detalhada (usada em documentação ou helps extensos).\n - Path: selectionMode\n Category: behavior\n Kind: enum\n Description: Semântica de seleção explícita para controles de escolha.\n - Path: variant\n Category: appearance\n Kind: string\n Description: Variante visual/semântica do controle.\n - Path: density\n Category: appearance\n Kind: enum\n Description: Densidade visual do shell do controle.\n - Path: links\n Category: identity\n Kind: array\n Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n - Path: group\n Category: identity\n Kind: string\n Description: Agrupador lógico do campo.\n - Path: order\n Category: layout\n Kind: number\n Description: Ordem de exibição do campo.\n - Path: width\n Category: layout\n Kind: string\n Description: Largura do campo (ex: 50%, 100px).\n - Path: isFlex\n Category: layout\n Kind: boolean\n Description: Se true, usa flex-grow para preencher espaço.\n - Path: controlType\n Category: behavior\n Kind: enum\n Description: Tipo do componente de UI (input, select, datepicker, etc).\n - Path: dataType\n Category: data\n Kind: enum\n Description: Tipo de dado do campo (text, number, date, etc).\n - Path: source\n Category: data\n Kind: enum\n Description: Origem semântica do campo. Use local para campos do host que não vêm do schema backend.\n - Path: transient\n Category: data\n Kind: boolean\n Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n - Path: submitPolicy\n Category: behavior\n Kind: enum\n Description: Política de submit para sobrescrever o padrão de campos locais/transient.\n - Path: materialDesign.appearance\n Category: appearance\n Kind: enum\n Description: Aparência do campo Material (fill/outline).\n - Path: materialDesign.color\n Category: appearance\n Kind: enum\n Description: Tema de cor Material (primary/accent/warn).\n - Path: materialDesign.floatLabel\n Category: appearance\n Kind: enum\n Description: Comportamento do rótulo flutuante.\n - Path: materialDesign.subscriptSizing\n Category: appearance\n Kind: enum\n Description: Estratégia de sizing do subscript (erros/hints).\n - Path: materialDesign.hideRequiredMarker\n Category: appearance\n Kind: boolean\n Description: Oculta o asterisco de campo obrigatório.\n - Path: materialDesign.density\n Category: appearance\n Kind: enum\n Description: Densidade do campo Material.\n - Path: materialDesign.disableRipple\n Category: appearance\n Kind: boolean\n Description: Desativa ripple/ondulação em componentes Material.\n - Path: materialDesign.customPalette\n Category: appearance\n Kind: object\n Description: Override de paleta (primary/accent/warn).\n - Path: materialDesign.animations\n Category: appearance\n Kind: object\n Description: Configuração de animações (disable, duration, easing).\n - Path: prefixIcon\n Category: appearance\n Kind: string\n Description: Ícone exibido antes do valor.\n - Path: suffixIcon\n Category: appearance\n Kind: string\n Description: Ícone exibido depois do valor.\n - Path: iconPosition\n Category: appearance\n Kind: enum\n Description: Posição preferencial do ícone principal.\n - Path: iconSize\n Category: appearance\n Kind: enum\n Description: Tamanho do ícone.\n - Path: iconColor\n Category: appearance\n Kind: string\n Description: Cor semântica ou token de cor aplicado ao ícone principal.\n - Path: iconClass\n Category: appearance\n Kind: string\n Description: Classe CSS controlada pelo host para o ícone principal.\n - Path: iconStyle\n Category: appearance\n Kind: string\n Description: Estilo visual semântico do ícone quando o renderer suportar variações.\n - Path: iconFontSize\n Category: appearance\n Kind: string\n Description: Tamanho tipográfico do ícone principal.\n - Path: valuePresentation\n Category: appearance\n Kind: object\n Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n - Path: presentation\n Category: appearance\n Kind: object\n Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n - Path: presentation.presenter\n Category: appearance\n Kind: enum\n Description: Tipo semantico de renderizacao em modo apresentacao.\n - Path: presentation.tone\n Category: appearance\n Kind: enum\n Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n - Path: presentation.appearance\n Category: appearance\n Kind: enum\n Description: Nivel de enfase visual do apresentador.\n - Path: presentation.icon\n Category: appearance\n Kind: string\n Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n - Path: presentation.label\n Category: identity\n Kind: string\n Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n - Path: presentation.badge\n Category: appearance\n Kind: string\n Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n - Path: presentation.valuePresentation\n Category: appearance\n Kind: object\n Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n - Path: presentation.visualization\n Category: appearance\n Kind: object\n Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n - Path: presentation.visualization.kind\n Category: appearance\n Kind: enum\n Description: Tipo semantico da micro visualizacao de apresentacao.\n - Path: presentation.visualization.surface\n Category: layout\n Kind: enum\n Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n - Path: presentation.visualization.size\n Category: layout\n Kind: enum\n Description: Tamanho semantico da micro visualizacao.\n - Path: presentation.visualization.fallbackText\n Category: accessibility\n Kind: string\n Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n - Path: presentationRules\n Category: appearance\n Kind: array\n Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n - Path: presentationRules[].when\n Category: behavior\n Kind: object\n Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n - Path: presentationRules[].set\n Category: appearance\n Kind: object\n Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\n - Path: mask\n Category: appearance\n Kind: string\n Description: Máscara de input (padrão do componente).\n - Path: format\n Category: appearance\n Kind: string\n Description: Formato de exibição (ex: pipes).\n - Path: validators\n Category: validation\n Kind: object\n Description: Objeto contendo todas as regras de validação.\n - Path: validators.required\n Category: validation\n Kind: boolean\n Description: Campo obrigatório.\n - Path: required\n Category: validation\n Kind: boolean\n Description: Campo obrigatório (alias rápido do validators.required).\n - Path: validators.requiredMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para required.\n - Path: validators.email\n Category: validation\n Kind: boolean\n Description: Validação de formato de e-mail.\n - Path: validators.emailMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para validação de email.\n - Path: validators.minLength\n Category: validation\n Kind: number\n Description: Comprimento mínimo do texto.\n - Path: validators.minLengthMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para minLength.\n - Path: validators.maxLength\n Category: validation\n Kind: number\n Description: Comprimento máximo do texto.\n - Path: validators.maxLengthMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para maxLength.\n - Path: validators.min\n Category: validation\n Kind: number\n Description: Valor numérico mínimo.\n - Path: validators.minMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para min.\n - Path: validators.max\n Category: validation\n Kind: number\n Description: Valor numérico máximo.\n - Path: validators.maxMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para max.\n - Path: validators.pattern\n Category: validation\n Kind: string\n Description: Regex para validação.\n - Path: validators.patternMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para pattern.\n - Path: validators.cpf\n Category: validation\n Kind: boolean\n Description: Validador de CPF (legado).\n - Path: validators.cnpj\n Category: validation\n Kind: boolean\n Description: Validador de CNPJ (legado).\n - Path: validators.cpfCnpj\n Category: validation\n Kind: boolean\n Description: Validador automatico CPF/CNPJ (legado).\n - Path: validators.cnpjAlpha\n Category: validation\n Kind: boolean\n Description: Validador de CNPJ alfanumerico (legado).\n - Path: validators.cpfMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CPF.\n - Path: validators.cnpjMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CNPJ.\n - Path: validators.cnpjAlphaMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CNPJ alfanumerico.\n - Path: validators.url\n Category: validation\n Kind: boolean\n Description: Validador de URL.\n - Path: validators.urlMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para URL.\n - Path: validators.minWords\n Category: validation\n Kind: number\n Description: Mínimo de palavras.\n - Path: validators.requiredChecked\n Category: validation\n Kind: boolean\n Description: Exige checkbox marcado (ex: termos de uso).\n - Path: validators.customValidator\n Category: validation\n Kind: expression\n Description: Validador customizado (função).\n - Path: validators.asyncValidator\n Category: validation\n Kind: expression\n Description: Validador async customizado (função).\n - Path: validators.matchField\n Category: validation\n Kind: string\n Description: Campo que deve coincidir (cross-field).\n - Path: validators.matchFieldMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para matchField.\n - Path: validators.uniqueValidator\n Category: validation\n Kind: expression\n Description: Validador de unicidade via API (função).\n - Path: validators.uniqueMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para unicidade.\n - Path: validators.conditionalValidation\n Category: validation\n Kind: array\n Description: Regras de validação condicional.\n - Path: validators.conditionalValidation[].condition\n Category: validation\n Kind: expression\n Description: Condicao para aplicar validadores.\n - Path: validators.conditionalValidation[].validators\n Category: validation\n Kind: object\n Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n - Path: validators.validationTrigger\n Category: validation\n Kind: enum\n Description: Gatilho de validação no validator.\n - Path: validators.validationDebounce\n Category: validation\n Kind: number\n Description: Debounce de validação no validator (ms).\n - Path: validators.showInlineErrors\n Category: validation\n Kind: boolean\n Description: Exibe erros inline (validator).\n - Path: validators.errorPosition\n Category: validation\n Kind: enum\n Description: Posicao do erro (validator).\n - Path: validationMode\n Category: validation\n Kind: enum\n Description: Gatilho da validação (change/blur/submit).\n - Path: debounceTime\n Category: validation\n Kind: number\n Description: Debounce para validação em ms.\n - Path: options\n Category: data\n Kind: array\n Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n - Path: endpoint\n Category: data\n Kind: string\n Description: URL para carregar opções remotas.\n - Path: valueField\n Category: data\n Kind: string\n Description: Nome da propriedade de valor nas opções.\n - Path: displayField\n Category: data\n Kind: string\n Description: Nome da propriedade de texto nas opções.\n - Path: filterField\n Category: data\n Kind: string\n Description: Campo para filtragem no backend.\n - Path: queryParams\n Category: data\n Kind: object\n Description: Parâmetros fixos para a query do endpoint.\n - Path: cacheDuration\n Category: data\n Kind: number\n Description: Duração do cache de dados em ms.\n - Path: hidden\n Category: behavior\n Kind: boolean\n Description: Oculta o campo globalmente.\n - Path: visibleIn\n Category: behavior\n Kind: array\n Description: Contextos onde o campo é visível.\n - Path: formHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas no formulário.\n - Path: tableHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas na tabela.\n - Path: filterHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas no filtro.\n - Path: dependencyFields\n Category: dependency\n Kind: array\n Description: Campos dos quais este campo depende.\n - Path: conditionalRequired\n Category: dependency\n Kind: expression\n Description: Condição Json Logic para obrigatoriedade declarativa.\n - Path: conditionalDisplay\n Category: dependency\n Kind: expression\n Description: Condição Json Logic para visibilidade declarativa.\n - Path: dependencyFilterMap\n Category: dependency\n Kind: object\n Description: Mapeamento de filtro baseado na dependência.\n - Path: dependencyValuePath\n Category: dependency\n Kind: string\n Description: Caminho no valor da dependência.\n - Path: dependencyMergeStrategy\n Category: dependency\n Kind: enum\n Description: Estratégia de merge dos dados carregados.\n - Path: dependencyLoadOnChange\n Category: dependency\n Kind: enum\n Description: Quando recarregar dependência.\n - Path: resetOnDependentChange\n Category: dependency\n Kind: boolean\n Description: Zera valor se dependência mudar.\n - Path: enableDependencyCascade\n Category: dependency\n Kind: boolean\n Description: Habilita/desabilita cascata nativa de dependências entre campos.\n - Path: dependencyDebounceMs\n Category: dependency\n Kind: number\n Description: Delay para reagir à mudança de dependência.\n - Path: suppressInlineErrorsOnCascade\n Category: dependency\n Kind: boolean\n Description: Suprime erros inline durante cascata.\n - Path: transformDisplayValue\n Category: transform\n Kind: expression\n Description: Transforma valor para exibição.\n - Path: transformSaveValue\n Category: transform\n Kind: expression\n Description: Transforma valor para salvar.\n - Path: textTransformApply\n Category: transform\n Kind: enum\n Description: Quando aplicar transformação de texto.\n - Path: inlineEditing\n Category: behavior\n Kind: boolean\n Description: Permite edição inline (tabelas).\n - Path: unique\n Category: validation\n Kind: boolean\n Description: Valida unicidade no backend.\n - Path: readOnly\n Category: behavior\n Kind: boolean\n Description: Campo somente leitura.\n - Path: disabled\n Category: behavior\n Kind: boolean\n Description: Campo desabilitado.\n - Path: defaultValue\n Category: data\n Kind: object\n Description: Valor inicial do campo.\n - Path: ariaLabel\n Category: accessibility\n Kind: string\n Description: Label para leitores de tela.\n - Path: ariaDescribedBy\n Category: accessibility\n Kind: string\n Description: IDs de descrição acessível.\n - Path: tabIndex\n Category: accessibility\n Kind: number\n Description: Ordem de tabulacao para teclado.\n - Path: accessKey\n Category: accessibility\n Kind: string\n Description: Atalho de teclado (accessKey).\n", "sourcePointer": "praxis-ui-angular/projects/praxis-core/src/lib/ai/field-metadata-ai-capabilities.ts", "contentHash": "466e427814fe510e5b0108e418a13f828b5a363d3da46bf9b69be588c7088ce2", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"text-input\",\n \"title\": \"Text input controls\",\n \"description\": \"Profile for text-like controls, including inline and Material text inputs.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-email-input\",\n \"pdx-inline-input\",\n \"pdx-inline-phone\",\n \"pdx-material-textarea\",\n \"pdx-password-input\",\n \"pdx-phone-input\",\n \"pdx-search-input\",\n \"pdx-text-input\",\n \"pdx-url-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.text.configure\",\n \"title\": \"Configure text field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"placeholder\": {\n \"type\": \"string\"\n },\n \"minLength\": {\n \"type\": \"number\"\n },\n \"maxLength\": {\n \"type\": \"number\"\n },\n \"pattern\": {\n \"type\": \"string\"\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"autocomplete\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"text-metadata-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.placeholder\",\n \"fieldMetadata.minLength\",\n \"fieldMetadata.maxLength\",\n \"fieldMetadata.pattern\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.autocomplete\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"text-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP001\",\n \"description\": \"Text constraints must preserve string field semantics and editor/runtime round-trip.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-text-placeholder-and-length\",\n \"request\": \"Set placeholder and maximum length for a text input.\",\n \"operationId\": \"field.text.configure\",\n \"params\": {\n \"placeholder\": \"Search by name\",\n \"maxLength\": 120\n },\n \"isPositive\": true\n }\n ],\n \"roundTripRequirements\": [\n \"Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state.\"\n ]\n },\n {\n \"profileId\": \"numeric\",\n \"title\": \"Numeric controls\",\n \"description\": \"Profile for number, slider, range, rating, distance and score controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-distance-radius\",\n \"pdx-inline-number\",\n \"pdx-inline-range-slider\",\n \"pdx-inline-rating\",\n \"pdx-inline-score-priority\",\n \"pdx-material-range-slider\",\n \"pdx-material-rating\",\n \"pdx-material-slider\",\n \"pdx-number-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Numeric metadata paths such as min, max, step, precision and display format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.numeric.configure\",\n \"title\": \"Configure numeric field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"step\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"displayFormat\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"numeric-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.step\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.displayFormat\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"numeric-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP002\",\n \"description\": \"Numeric min, max, step and precision must be mutually valid for the target control.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-rating-scale\",\n \"request\": \"Set rating control to five points with half-step increments.\",\n \"operationId\": \"field.numeric.configure\",\n \"params\": {\n \"min\": 0,\n \"max\": 5,\n \"step\": 0.5\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"currency\",\n \"title\": \"Currency controls\",\n \"description\": \"Profile for currency and price-range controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-currency\",\n \"pdx-inline-currency-range\",\n \"pdx-material-currency\",\n \"pdx-material-price-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Currency metadata paths such as currency code, locale, precision and range mode.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.currency.configure\",\n \"title\": \"Configure currency field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"currencyCode\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"number\"\n },\n \"max\": {\n \"type\": \"number\"\n },\n \"precision\": {\n \"type\": \"number\"\n },\n \"rangeMode\": {\n \"enum\": [\n \"single\",\n \"range\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"currency-code-valid\",\n \"currency-range-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.currencyCode\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.precision\",\n \"fieldMetadata.rangeMode\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"currency-code-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP003\",\n \"description\": \"Currency controls require a valid ISO currency code and locale-aware formatting semantics.\"\n },\n {\n \"validatorId\": \"currency-range-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP004\",\n \"description\": \"Currency range bounds must be ordered and compatible with precision.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-brl-currency\",\n \"request\": \"Configure the currency field for Brazilian Real with two decimals.\",\n \"operationId\": \"field.currency.configure\",\n \"params\": {\n \"currencyCode\": \"BRL\",\n \"locale\": \"pt-BR\",\n \"precision\": 2\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"select\",\n \"title\": \"Select controls\",\n \"description\": \"Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-async-select\",\n \"pdx-inline-autocomplete\",\n \"pdx-inline-color-label\",\n \"pdx-inline-multi-select\",\n \"pdx-inline-pipeline-status\",\n \"pdx-inline-searchable-select\",\n \"pdx-inline-select\",\n \"pdx-inline-sentiment\",\n \"pdx-material-async-select\",\n \"pdx-material-autocomplete\",\n \"pdx-material-button-toggle\",\n \"pdx-material-checkbox-group\",\n \"pdx-material-chips\",\n \"pdx-material-multi-select\",\n \"pdx-material-radio-group\",\n \"pdx-material-searchable-select\",\n \"pdx-material-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Option source, local options, display/value fields, search and multi-select metadata paths.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.select.configure\",\n \"title\": \"Configure select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"options\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n },\n \"async\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.options\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.searchable\",\n \"fieldMetadata.async\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-select-options\",\n \"request\": \"Configure select to store ids and display labels.\",\n \"operationId\": \"field.select.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"entity-lookup\",\n \"title\": \"Entity lookup controls\",\n \"description\": \"Profile for entity lookup controls that bind to remote resources.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-entity-lookup\",\n \"pdx-inline-entity-lookup\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Entity lookup metadata paths such as resourcePath, value/display fields and search behavior.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.entityLookup.configure\",\n \"title\": \"Configure entity lookup field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"resourcePath\": {\n \"type\": \"string\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"searchable\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"entity-resource-binding-valid\",\n \"option-source-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.resourcePath\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.searchable\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"entity-resource-binding-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP007\",\n \"description\": \"Entity lookup controls require canonical resource binding and stable value/display identity fields.\"\n },\n {\n \"validatorId\": \"option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP005\",\n \"description\": \"Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-entity-lookup\",\n \"request\": \"Bind the entity lookup to users and show the name while storing the id.\",\n \"operationId\": \"field.entityLookup.configure\",\n \"params\": {\n \"optionSource\": {\n \"key\": \"user\",\n \"type\": \"RESOURCE_ENTITY\",\n \"resourcePath\": \"/users\",\n \"valuePropertyPath\": \"id\",\n \"labelPropertyPath\": \"name\",\n \"includeIds\": false,\n \"capabilities\": {\n \"filter\": true,\n \"byIds\": true\n },\n \"dependsOn\": [\n \"companyId\"\n ],\n \"dependencyFilterMap\": {\n \"companyId\": \"companyId\"\n }\n },\n \"valueField\": \"id\",\n \"displayField\": \"name\",\n \"searchable\": true\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"tree-select\",\n \"title\": \"Tree select controls\",\n \"description\": \"Profile for hierarchical tree select controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-tree-select\",\n \"pdx-material-multi-select-tree\",\n \"pdx-material-tree-select\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.treeSelect.configure\",\n \"title\": \"Configure tree select field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"optionSource\": {\n \"type\": \"object\"\n },\n \"nodeIdField\": {\n \"type\": \"string\"\n },\n \"parentIdField\": {\n \"type\": \"string\"\n },\n \"childrenField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"lazyLoad\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"tree-node-identity-valid\",\n \"tree-option-source-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.optionSource\",\n \"fieldMetadata.nodeIdField\",\n \"fieldMetadata.parentIdField\",\n \"fieldMetadata.childrenField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.lazyLoad\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"tree-node-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP008\",\n \"description\": \"Tree controls require stable node identity and valid parent/children references.\"\n },\n {\n \"validatorId\": \"tree-option-source-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP009\",\n \"description\": \"Tree option sources must expose hierarchical data compatible with the configured node fields.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-tree-select\",\n \"request\": \"Configure tree select with id, parentId and children fields.\",\n \"operationId\": \"field.treeSelect.configure\",\n \"params\": {\n \"nodeIdField\": \"id\",\n \"parentIdField\": \"parentId\",\n \"childrenField\": \"children\"\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"list-transfer\",\n \"title\": \"List and transfer controls\",\n \"description\": \"Profile for selection-list and transfer-list controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-selection-list\",\n \"pdx-material-transfer-list\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"List option metadata paths such as options, selection mode, value field and ordering.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.list.configure\",\n \"title\": \"Configure list field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"options\": {\n \"type\": \"array\"\n },\n \"transferOptions\": {\n \"type\": \"array\"\n },\n \"valueField\": {\n \"type\": \"string\"\n },\n \"displayField\": {\n \"type\": \"string\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"ordered\": {\n \"type\": \"boolean\"\n },\n \"maxSelections\": {\n \"type\": \"number\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"list-selection-valid\",\n \"option-identity-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.options\",\n \"fieldMetadata.transferOptions\",\n \"fieldMetadata.valueField\",\n \"fieldMetadata.displayField\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.ordered\",\n \"fieldMetadata.maxSelections\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"list-selection-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP010\",\n \"description\": \"List selection metadata must preserve stable option identity and selected value shape.\"\n },\n {\n \"validatorId\": \"option-identity-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP006\",\n \"description\": \"Value and display identity fields must exist in local options or the remote option source schema.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-transfer-list\",\n \"request\": \"Configure transfer list to store ids and display labels with a maximum of three selected items.\",\n \"operationId\": \"field.list.configure\",\n \"params\": {\n \"valueField\": \"id\",\n \"displayField\": \"label\",\n \"multiple\": true,\n \"ordered\": true,\n \"maxSelections\": 3\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"date\",\n \"title\": \"Date controls\",\n \"description\": \"Profile for single date, datetime, month, week, year and time picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-date-input\",\n \"pdx-datetime-local-input\",\n \"pdx-inline-date\",\n \"pdx-inline-time\",\n \"pdx-material-datepicker\",\n \"pdx-material-timepicker\",\n \"pdx-month-input\",\n \"pdx-time-input\",\n \"pdx-week-input\",\n \"pdx-year-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date/time metadata paths such as min, max, timezone, locale and format.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.date.configure\",\n \"title\": \"Configure date or time field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"timezone\": {\n \"type\": \"string\"\n },\n \"locale\": {\n \"type\": \"string\"\n },\n \"format\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"temporal-bounds-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.timezone\",\n \"fieldMetadata.locale\",\n \"fieldMetadata.format\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-min-max\",\n \"request\": \"Limit the date field to the current year in Sao Paulo timezone.\",\n \"operationId\": \"field.date.configure\",\n \"params\": {\n \"min\": \"2026-01-01\",\n \"max\": \"2026-12-31\",\n \"timezone\": \"America/Sao_Paulo\"\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"date-range\",\n \"title\": \"Date range controls\",\n \"description\": \"Profile for date range, month range, year range, period and relative-period controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-date-range\",\n \"pdx-inline-month-range\",\n \"pdx-inline-period-range\",\n \"pdx-inline-relative-period\",\n \"pdx-inline-year-range\",\n \"pdx-material-date-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Date range metadata paths such as start/end field mapping, min/max and presets.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.dateRange.configure\",\n \"title\": \"Configure date range field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"startField\": {\n \"type\": \"string\"\n },\n \"endField\": {\n \"type\": \"string\"\n },\n \"min\": {\n \"type\": \"string\"\n },\n \"max\": {\n \"type\": \"string\"\n },\n \"presets\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"date-range-fields-valid\",\n \"temporal-bounds-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.startField\",\n \"fieldMetadata.endField\",\n \"fieldMetadata.min\",\n \"fieldMetadata.max\",\n \"fieldMetadata.presets\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"date-range-fields-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP013\",\n \"description\": \"Date range controls require distinct start/end field semantics and ordered submitted values.\"\n },\n {\n \"validatorId\": \"temporal-bounds-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP011\",\n \"description\": \"Temporal min and max values must be valid and ordered for the target control granularity.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-date-range-fields\",\n \"request\": \"Use createdFrom and createdTo as the date range field names.\",\n \"operationId\": \"field.dateRange.configure\",\n \"params\": {\n \"startField\": \"createdFrom\",\n \"endField\": \"createdTo\"\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"time-range\",\n \"title\": \"Time range controls\",\n \"description\": \"Profile for time range controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-time-range\",\n \"pdx-material-time-range\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Time range metadata paths such as start/end fields, step minutes and timezone.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.timeRange.configure\",\n \"title\": \"Configure time range field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"startField\": {\n \"type\": \"string\"\n },\n \"endField\": {\n \"type\": \"string\"\n },\n \"stepMinutes\": {\n \"type\": \"number\"\n },\n \"timezone\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"time-range-fields-valid\",\n \"timezone-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.startField\",\n \"fieldMetadata.endField\",\n \"fieldMetadata.stepMinutes\",\n \"fieldMetadata.timezone\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"time-range-fields-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP014\",\n \"description\": \"Time range controls require distinct start/end field semantics and valid interval steps.\"\n },\n {\n \"validatorId\": \"timezone-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP012\",\n \"description\": \"Timezone configuration must use a valid named timezone when the control is timezone-sensitive.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-time-range-step\",\n \"request\": \"Configure a time range with fifteen minute increments.\",\n \"operationId\": \"field.timeRange.configure\",\n \"params\": {\n \"stepMinutes\": 15\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"toggle\",\n \"title\": \"Toggle controls\",\n \"description\": \"Profile for boolean toggle controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-inline-toggle\",\n \"pdx-material-slide-toggle\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Boolean metadata paths such as true label, false label and default value.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.toggle.configure\",\n \"title\": \"Configure toggle field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"trueLabel\": {\n \"type\": \"string\"\n },\n \"falseLabel\": {\n \"type\": \"string\"\n },\n \"defaultValue\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"boolean-toggle-compatible\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.trueLabel\",\n \"fieldMetadata.falseLabel\",\n \"fieldMetadata.defaultValue\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"boolean-toggle-compatible\",\n \"level\": \"error\",\n \"code\": \"PDFP015\",\n \"description\": \"Toggle controls must preserve boolean value semantics and not serialize labels as submitted values.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-toggle-labels\",\n \"request\": \"Set yes/no labels for a toggle without changing boolean submission.\",\n \"operationId\": \"field.toggle.configure\",\n \"params\": {\n \"trueLabel\": \"Yes\",\n \"falseLabel\": \"No\"\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"color\",\n \"title\": \"Color controls\",\n \"description\": \"Profile for color input and picker controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-color-input\",\n \"pdx-color-picker\",\n \"pdx-material-colorpicker\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Color metadata paths such as format, alpha support and palette presets.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.color.configure\",\n \"title\": \"Configure color field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"format\": {\n \"enum\": [\n \"hex\",\n \"rgb\",\n \"rgba\"\n ]\n },\n \"allowAlpha\": {\n \"type\": \"boolean\"\n },\n \"palette\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"color-format-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.format\",\n \"fieldMetadata.allowAlpha\",\n \"fieldMetadata.palette\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"color-format-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP016\",\n \"description\": \"Color values and palette entries must match the configured color format.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-color-hex-palette\",\n \"request\": \"Use hex colors and offer brand palette presets.\",\n \"operationId\": \"field.color.configure\",\n \"params\": {\n \"format\": \"hex\",\n \"allowAlpha\": false,\n \"palette\": [\n \"#0057B8\",\n \"#00A676\"\n ]\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"regional-document\",\n \"title\": \"Regional document controls\",\n \"description\": \"Profile for Brazilian CPF/CNPJ document input controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-cpf-cnpj-input\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Regional document metadata paths such as document type, mask and validation mode.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.regionalDocument.configure\",\n \"title\": \"Configure regional document field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"documentType\": {\n \"enum\": [\n \"cpf\",\n \"cnpj\",\n \"cpfOrCnpj\"\n ]\n },\n \"mask\": {\n \"type\": \"string\"\n },\n \"validateChecksum\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"regional-document-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.documentType\",\n \"fieldMetadata.mask\",\n \"fieldMetadata.validateChecksum\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"regional-document-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP017\",\n \"description\": \"Regional document controls must preserve document type, mask and checksum validation semantics.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-cpf-cnpj-document\",\n \"request\": \"Accept CPF or CNPJ and validate the document checksum.\",\n \"operationId\": \"field.regionalDocument.configure\",\n \"params\": {\n \"documentType\": \"cpfOrCnpj\",\n \"validateChecksum\": true\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"file-upload\",\n \"title\": \"File upload controls\",\n \"description\": \"Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-file-upload\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.fileUpload.configure\",\n \"title\": \"Configure file upload field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"accept\": {\n \"type\": \"array\"\n },\n \"maxFileSize\": {\n \"type\": \"number\"\n },\n \"multiple\": {\n \"type\": \"boolean\"\n },\n \"maxFiles\": {\n \"type\": \"number\"\n },\n \"uploadEndpoint\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"file-upload-policy-valid\",\n \"file-upload-endpoint-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.accept\",\n \"fieldMetadata.maxFileSize\",\n \"fieldMetadata.multiple\",\n \"fieldMetadata.maxFiles\",\n \"fieldMetadata.uploadEndpoint\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"file-upload-policy-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP020\",\n \"description\": \"File upload controls require explicit file type, size and multiplicity constraints before storage binding.\"\n },\n {\n \"validatorId\": \"file-upload-endpoint-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP021\",\n \"description\": \"Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-pdf-upload\",\n \"request\": \"Allow up to three PDF files with a five megabyte limit.\",\n \"operationId\": \"field.fileUpload.configure\",\n \"params\": {\n \"accept\": [\n \"application/pdf\"\n ],\n \"maxFileSize\": 5242880,\n \"multiple\": true,\n \"maxFiles\": 3\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"collection\",\n \"title\": \"Collection controls\",\n \"description\": \"Profile for repeatable collection controls that manage array-shaped field values.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-editable-collection\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.collection.configure\",\n \"title\": \"Configure collection field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"itemSchema\": {\n \"type\": \"object\"\n },\n \"minItems\": {\n \"type\": \"number\"\n },\n \"maxItems\": {\n \"type\": \"number\"\n },\n \"ordered\": {\n \"type\": \"boolean\"\n },\n \"allowAdd\": {\n \"type\": \"boolean\"\n },\n \"allowRemove\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"collection-item-schema-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.itemSchema\",\n \"fieldMetadata.minItems\",\n \"fieldMetadata.maxItems\",\n \"fieldMetadata.ordered\",\n \"fieldMetadata.allowAdd\",\n \"fieldMetadata.allowRemove\"\n ],\n \"submissionImpact\": \"affects-schema-backed-data\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"collection-item-schema-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP022\",\n \"description\": \"Collection controls require array-compatible item schema and stable item identity semantics.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-repeatable-addresses\",\n \"request\": \"Configure a repeatable address collection with at least one item.\",\n \"operationId\": \"field.collection.configure\",\n \"params\": {\n \"minItems\": 1,\n \"ordered\": true,\n \"allowAdd\": true,\n \"allowRemove\": true\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"avatar\",\n \"title\": \"Avatar controls\",\n \"description\": \"Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-avatar\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.avatar.configure\",\n \"title\": \"Configure avatar field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"extra\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"imageSrc\": {\n \"type\": \"string\"\n },\n \"imageAlt\": {\n \"type\": \"string\"\n },\n \"initials\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"defaultIcon\": {\n \"type\": \"string\"\n },\n \"themeColor\": {\n \"enum\": [\n \"primary\",\n \"secondary\",\n \"tertiary\",\n \"base\",\n \"info\",\n \"success\",\n \"warning\",\n \"error\",\n \"dark\",\n \"light\",\n \"inverse\",\n \"none\"\n ]\n },\n \"rounded\": {\n \"enum\": [\n \"full\",\n \"large\",\n \"medium\",\n \"small\",\n \"none\"\n ]\n },\n \"size\": {\n \"enum\": [\n \"xsmall\",\n \"small\",\n \"medium\",\n \"large\",\n \"xlarge\",\n \"xxlarge\",\n \"none\"\n ]\n },\n \"fillMode\": {\n \"enum\": [\n \"solid\",\n \"outline\",\n \"none\"\n ]\n },\n \"border\": {\n \"type\": \"boolean\"\n },\n \"status\": {\n \"enum\": [\n \"online\",\n \"offline\",\n \"busy\",\n \"away\",\n \"verified\",\n \"none\"\n ]\n },\n \"statusLabel\": {\n \"type\": \"string\"\n },\n \"badge\": {\n \"oneOf\": [\n {\n \"type\": \"string\"\n },\n {\n \"type\": \"number\"\n }\n ]\n },\n \"badgeLabel\": {\n \"type\": \"string\"\n },\n \"emphasis\": {\n \"enum\": [\n \"none\",\n \"ring\",\n \"halo\"\n ]\n },\n \"emphasisColor\": {\n \"enum\": [\n \"primary\",\n \"secondary\",\n \"tertiary\",\n \"base\",\n \"info\",\n \"success\",\n \"warning\",\n \"error\",\n \"dark\",\n \"light\",\n \"inverse\",\n \"none\"\n ]\n },\n \"emphasisLabel\": {\n \"type\": \"string\"\n },\n \"initialsMaxLength\": {\n \"type\": \"number\",\n \"minimum\": 1,\n \"maximum\": 4\n },\n \"tooltip\": {\n \"type\": \"string\"\n },\n \"ariaLabel\": {\n \"type\": \"string\"\n },\n \"groupLabel\": {\n \"type\": \"string\"\n },\n \"groupMaxVisible\": {\n \"type\": \"number\",\n \"minimum\": 1,\n \"maximum\": 12\n },\n \"groupOverflowLabel\": {\n \"type\": \"string\"\n },\n \"groupOverlap\": {\n \"type\": \"number\",\n \"minimum\": 0,\n \"maximum\": 32\n },\n \"groupItems\": {\n \"type\": \"array\",\n \"minItems\": 1,\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"imageSrc\": {\n \"type\": \"string\"\n },\n \"imageAlt\": {\n \"type\": \"string\"\n },\n \"initials\": {\n \"type\": \"string\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"defaultIcon\": {\n \"type\": \"string\"\n },\n \"themeColor\": {\n \"enum\": [\n \"primary\",\n \"secondary\",\n \"tertiary\",\n \"base\",\n \"info\",\n \"success\",\n \"warning\",\n \"error\",\n \"dark\",\n \"light\",\n \"inverse\",\n \"none\"\n ]\n },\n \"rounded\": {\n \"enum\": [\n \"full\",\n \"large\",\n \"medium\",\n \"small\",\n \"none\"\n ]\n },\n \"fillMode\": {\n \"enum\": [\n \"solid\",\n \"outline\",\n \"none\"\n ]\n },\n \"status\": {\n \"enum\": [\n \"online\",\n \"offline\",\n \"busy\",\n \"away\",\n \"verified\",\n \"none\"\n ]\n },\n \"statusLabel\": {\n \"type\": \"string\"\n },\n \"emphasis\": {\n \"enum\": [\n \"none\",\n \"ring\",\n \"halo\"\n ]\n },\n \"emphasisColor\": {\n \"enum\": [\n \"primary\",\n \"secondary\",\n \"tertiary\",\n \"base\",\n \"info\",\n \"success\",\n \"warning\",\n \"error\",\n \"dark\",\n \"light\",\n \"inverse\",\n \"none\"\n ]\n },\n \"emphasisLabel\": {\n \"type\": \"string\"\n },\n \"tooltip\": {\n \"type\": \"string\"\n },\n \"ariaLabel\": {\n \"type\": \"string\"\n }\n },\n \"additionalProperties\": false\n }\n }\n },\n \"additionalProperties\": false\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"avatar-presentation-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.extra.imageSrc\",\n \"fieldMetadata.extra.imageAlt\",\n \"fieldMetadata.extra.initials\",\n \"fieldMetadata.extra.name\",\n \"fieldMetadata.extra.icon\",\n \"fieldMetadata.extra.defaultIcon\",\n \"fieldMetadata.extra.themeColor\",\n \"fieldMetadata.extra.rounded\",\n \"fieldMetadata.extra.size\",\n \"fieldMetadata.extra.fillMode\",\n \"fieldMetadata.extra.border\",\n \"fieldMetadata.extra.status\",\n \"fieldMetadata.extra.statusLabel\",\n \"fieldMetadata.extra.badge\",\n \"fieldMetadata.extra.badgeLabel\",\n \"fieldMetadata.extra.emphasis\",\n \"fieldMetadata.extra.emphasisColor\",\n \"fieldMetadata.extra.emphasisLabel\",\n \"fieldMetadata.extra.initialsMaxLength\",\n \"fieldMetadata.extra.tooltip\",\n \"fieldMetadata.extra.ariaLabel\",\n \"fieldMetadata.extra.groupLabel\",\n \"fieldMetadata.extra.groupMaxVisible\",\n \"fieldMetadata.extra.groupOverflowLabel\",\n \"fieldMetadata.extra.groupOverlap\",\n \"fieldMetadata.extra.groupItems\"\n ],\n \"submissionImpact\": \"visual-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"avatar-presentation-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP023\",\n \"description\": \"Avatar controls must keep display metadata separate from submitted domain value semantics.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-avatar-fields\",\n \"request\": \"Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.\",\n \"operationId\": \"field.avatar.configure\",\n \"params\": {\n \"extra\": {\n \"initials\": \"AL\",\n \"name\": \"Ada Lovelace\",\n \"defaultIcon\": \"person\",\n \"size\": \"large\",\n \"themeColor\": \"tertiary\",\n \"status\": \"verified\",\n \"statusLabel\": \"Verified profile\",\n \"badge\": 3,\n \"badgeLabel\": \"3 pending items\",\n \"emphasis\": \"ring\",\n \"emphasisColor\": \"success\",\n \"emphasisLabel\": \"Selected reviewer\",\n \"ariaLabel\": \"Avatar de Ada Lovelace\"\n }\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"display-action\",\n \"title\": \"Display and action controls\",\n \"description\": \"Profile for non-data or action-like field controls.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"pdx-material-button\",\n \"pdx-preload-status\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Display/action metadata paths such as label, icon, action id, loading state and presentation mode.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.displayAction.configure\",\n \"title\": \"Configure display/action field metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"actionId\": {\n \"type\": \"string\"\n },\n \"presentationOnly\": {\n \"type\": \"boolean\"\n },\n \"loadingStatePath\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"display-action-contract-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.label\",\n \"fieldMetadata.icon\",\n \"fieldMetadata.actionId\",\n \"fieldMetadata.presentationOnly\",\n \"fieldMetadata.loadingStatePath\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"display-action-contract-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP018\",\n \"description\": \"Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-action-button\",\n \"request\": \"Configure a button field to trigger the refresh action.\",\n \"operationId\": \"field.displayAction.configure\",\n \"params\": {\n \"label\": \"Refresh\",\n \"icon\": \"refresh\",\n \"actionId\": \"refresh\"\n },\n \"isPositive\": true\n }\n ]\n },\n {\n \"profileId\": \"field-shell\",\n \"title\": \"Field shell controls\",\n \"description\": \"Profile for wrapper/shell controls that host another field contract.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"praxis-field-shell\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Shell metadata paths such as label, hint, error projection, layout and child control reference.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.shell.configure\",\n \"title\": \"Configure field shell metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"hint\": {\n \"type\": \"string\"\n },\n \"errorMode\": {\n \"enum\": [\n \"inline\",\n \"summary\",\n \"none\"\n ]\n },\n \"childControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"field-shell-child-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.label\",\n \"fieldMetadata.hint\",\n \"fieldMetadata.errorMode\",\n \"fieldMetadata.childControlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"field-shell-child-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP019\",\n \"description\": \"Field shell controls must delegate child semantics to the child control profile instead of redefining them.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-field-shell-label\",\n \"request\": \"Set shell label and delegate rendering to inline select.\",\n \"operationId\": \"field.shell.configure\",\n \"params\": {\n \"label\": \"Status\",\n \"childControlType\": \"inlineSelect\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "0e801a8b6336d4d48e297581a9e53c4148ff95a0f757cd81b2a83699836a48aa", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 3, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-color-input | controlType: color\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-color-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"color\"\n ],\n \"useWhen\": \"criar campo color\",\n \"examplePrompts\": [\n \"crie um campo color\",\n \"adicione um color ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_color\",\n \"label\": \"Example color\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"color\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"format\": \"hex\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"color\",\n \"views\": [\n \"gradient\"\n ],\n \"activeView\": \"gradient\",\n \"preview\": true,\n \"clearButton\": true,\n \"actionsLayout\": \"start\",\n \"adaptiveMode\": true,\n \"adaptiveTitle\": \"example\",\n \"adaptiveSubtitle\": \"example\",\n \"popupSettings\": {\n \"example\": true\n },\n \"gradientSettings\": {\n \"example\": true\n },\n \"paletteSettings\": {\n \"example\": true\n },\n \"fillMode\": \"solid\",\n \"rounded\": \"none\",\n \"size\": \"small\",\n \"icon\": \"example\",\n \"iconClass\": \"example\",\n \"svgIcon\": \"example\",\n \"tabindex\": 1\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-color-input.json", "contentHash": "a45833ed15e99fe0016214361aad25f8fb51131a031b1e85eee8ad37d8382584", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 4, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-color-picker | controlType: colorPicker\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-color-picker\",\n \"tags\": [\n \"dynamic-fields\",\n \"color\"\n ],\n \"useWhen\": \"criar campo colorPicker\",\n \"examplePrompts\": [\n \"crie um campo colorPicker\",\n \"adicione um colorPicker ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_colorPicker\",\n \"label\": \"Example colorPicker\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"colorPicker\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"format\": \"hex\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"views\": [\n \"gradient\"\n ],\n \"activeView\": \"gradient\",\n \"preview\": true,\n \"clearButton\": true,\n \"actionsLayout\": \"start\",\n \"adaptiveMode\": true,\n \"adaptiveTitle\": \"example\",\n \"adaptiveSubtitle\": \"example\",\n \"popupSettings\": {\n \"example\": true\n },\n \"gradientSettings\": {\n \"example\": true\n },\n \"paletteSettings\": {\n \"example\": true\n },\n \"fillMode\": \"solid\",\n \"rounded\": \"none\",\n \"size\": \"small\",\n \"icon\": \"example\",\n \"iconClass\": \"example\",\n \"svgIcon\": \"example\",\n \"tabindex\": 1\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-color-picker.json", "contentHash": "27635d77d2963ed103a455e32fac0b0bfd6b9fef1fd1cb52978b2f4b43531bd8", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 5, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-date-input | controlType: dateInput | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-date-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"date-input\"\n ],\n \"useWhen\": \"capturar data pontual com entrada nativa e baixo custo de interface\",\n \"examplePrompts\": [\n \"crie um campo dateInput para data da fatura\",\n \"adicione dateInput para data de emissão\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"invoiceDate\",\n \"label\": \"Data da fatura\",\n \"placeholder\": \"aaaa-mm-dd\",\n \"controlType\": \"dateInput\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de data da fatura\"\n },\n \"hint\": \"Use formato de data local\",\n \"minDate\": \"2024-01-01\",\n \"maxDate\": \"2026-12-31\",\n \"ariaLabel\": \"Campo de data da fatura\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-date-input.json", "contentHash": "ef15fd26f7497ce460f9d62f93a7d4469990855f873279b3cb4d3b591d4640ae", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 6, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-datetime-local-input | controlType: dateTimeLocal | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-datetime-local-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"datetime-local\"\n ],\n \"useWhen\": \"capturar data e hora no mesmo ponto de entrada\",\n \"examplePrompts\": [\n \"crie um campo dateTimeLocal para agendamento\",\n \"adicione datetime local para evento\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"appointmentAt\",\n \"label\": \"Agendamento\",\n \"placeholder\": \"aaaa-mm-ddThh:mm\",\n \"controlType\": \"dateTimeLocal\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de agendamento\"\n },\n \"hint\": \"Data e hora local do atendimento\",\n \"stepMinute\": 15,\n \"ariaLabel\": \"Campo de data e hora do agendamento\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-datetime-local-input.json", "contentHash": "76d9e8710862b7442bcb84b60550fba2d700f5739c35d9655d9a650a0b899c1f", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 7, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-email-input | controlType: email\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-email-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo email\",\n \"examplePrompts\": [\n \"crie um campo email\",\n \"adicione um email ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_email\",\n \"label\": \"Example email\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"email\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"email\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-email-input.json", "contentHash": "0651759918052a540c56fdb2674bc980c301f144303dc203460dc31c1ab6acba", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 8, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-async-select | controlType: inlineAsyncSelect | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-async-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"async-select\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por catálogo remoto com carregamento sob demanda\",\n \"examplePrompts\": [\n \"crie um filtro inline remoto de equipe\",\n \"adicione inlineAsyncSelect para lookup remoto\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"teamId\",\n \"label\": \"Equipe\",\n \"placeholder\": \"Buscar equipe\",\n \"controlType\": \"inlineAsyncSelect\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de equipe\"\n },\n \"resourcePath\": \"/api/options/teams\",\n \"loadOn\": \"focus\",\n \"optionLabelKey\": \"name\",\n \"optionValueKey\": \"id\",\n \"filterField\": \"name\",\n \"queryParams\": {\n \"active\": true\n },\n \"emptyOptionText\": \"Todas as equipes\",\n \"ariaLabel\": \"Filtro remoto de equipe\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-async-select.json", "contentHash": "79b548502a73731d518958bb8499255d0e3635ffe6c60ffe854716ffd4096a65", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 9, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-autocomplete | controlType: inlineAutocomplete | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-autocomplete\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"autocomplete\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por termos conhecidos com sugestao incremental\",\n \"examplePrompts\": [\n \"crie um filtro inline com autocomplete de cidade\",\n \"adicione inlineAutocomplete para localidade\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"city\",\n \"label\": \"Cidade\",\n \"placeholder\": \"Digite para sugerir\",\n \"controlType\": \"inlineAutocomplete\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de cidade\"\n },\n \"options\": [\n {\n \"key\": \"Sao Paulo\",\n \"value\": \"sao-paulo\"\n },\n {\n \"key\": \"Rio de Janeiro\",\n \"value\": \"rio-de-janeiro\"\n },\n {\n \"key\": \"Belo Horizonte\",\n \"value\": \"belo-horizonte\"\n },\n {\n \"key\": \"Curitiba\",\n \"value\": \"curitiba\"\n }\n ],\n \"searchable\": true,\n \"debounceTime\": 200,\n \"ariaLabel\": \"Filtro com autocomplete de cidade\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-autocomplete.json", "contentHash": "d5b2674631f78d378692477da36ca0ae8578c1cbdce3f07c4372af6013afba60", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 10, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-color-label | controlType: inlineColorLabel | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-color-label\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"color-label\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por etiquetas coloridas quando o texto da opcao continua sendo o principal canal de leitura\",\n \"avoidWhen\": \"a cor sozinha carrega o significado ou o estado precisa continuar claro em acessibilidade sem apoio textual\",\n \"examplePrompts\": [\n \"crie um filtro inline de etiquetas por cor\",\n \"adicione inlineColorLabel para squads com badge textual\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"labels\",\n \"label\": \"Etiquetas\",\n \"placeholder\": \"Selecionar etiquetas\",\n \"controlType\": \"inlineColorLabel\",\n \"multiple\": true,\n \"colorLabelOptions\": [\n { \"id\": \"red\", \"label\": \"Critico\", \"value\": \"critical\", \"color\": \"#ef4444\" },\n { \"id\": \"yellow\", \"label\": \"Atencao\", \"value\": \"warning\", \"color\": \"#eab308\" },\n { \"id\": \"green\", \"label\": \"Estavel\", \"value\": \"stable\", \"color\": \"#22c55e\" }\n ],\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true\n },\n \"ariaLabel\": \"Filtro por etiquetas coloridas\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-color-label.json", "contentHash": "b0dc477312c86ec68fadf13b52cc5b38cf3821ff9d8e0bad2491792b9efff7ce", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 11, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-currency-range | controlType: inlineCurrencyRange | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-currency-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"currency\",\n \"range\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por faixa monetaria em processos comerciais\",\n \"examplePrompts\": [\n \"crie um filtro inline de faixa de preco\",\n \"adicione inlineCurrencyRange para orçamento\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"budgetRange\",\n \"label\": \"Faixa de valor\",\n \"placeholder\": \"R$ 1.000 ate R$ 8.000\",\n \"controlType\": \"inlineCurrencyRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de faixa de valor\"\n },\n \"currency\": \"BRL\",\n \"locale\": \"pt-BR\",\n \"decimalPlaces\": 2,\n \"allowNegative\": false,\n \"min\": 0,\n \"max\": 100000,\n \"step\": 100,\n \"startLabel\": \"De\",\n \"endLabel\": \"Ate\",\n \"startPlaceholder\": \"Minimo\",\n \"endPlaceholder\": \"Maximo\",\n \"rangeSeparator\": \"ate\",\n \"defaultValue\": {\n \"start\": 1000,\n \"end\": 8000\n },\n \"ariaLabel\": \"Filtro de faixa monetaria\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-currency-range.json", "contentHash": "cf561139937107aee730667c44ad6c1fccacb7673e472efc606c334f3df9f844", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 12, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-currency | controlType: inlineCurrency | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-currency\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"currency\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por valor monetario unico\",\n \"examplePrompts\": [\n \"crie um filtro inline de valor minimo\",\n \"adicione inlineCurrency para preco alvo\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"minValue\",\n \"label\": \"Valor minimo\",\n \"placeholder\": \"R$ 0,00\",\n \"controlType\": \"inlineCurrency\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de valor minimo\"\n },\n \"currency\": \"BRL\",\n \"locale\": \"pt-BR\",\n \"decimalPlaces\": 2,\n \"allowNegative\": false,\n \"min\": 0,\n \"ariaLabel\": \"Filtro de valor monetario minimo\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-currency.json", "contentHash": "22f38ed3d572a6464831dae5aac9fc692e1d4576dcac523cfdc2b85183bf50a9", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 13, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-date-range | controlType: inlineDateRange | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-date-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"date-range\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por intervalo de datas em auditoria e relatorios\",\n \"examplePrompts\": [\n \"crie um filtro inline de periodo\",\n \"adicione inlineDateRange para intervalo de criação\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"createdAtRange\",\n \"label\": \"Periodo\",\n \"placeholder\": \"Inicio e fim\",\n \"controlType\": \"inlineDateRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de periodo\"\n },\n \"minDate\": \"2024-01-01\",\n \"maxDate\": \"2026-12-31\",\n \"startPlaceholder\": \"Inicio\",\n \"endPlaceholder\": \"Fim\",\n \"rangeSeparator\": \"ate\",\n \"ariaLabel\": \"Filtro por periodo de datas\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-date-range.json", "contentHash": "0961c11fbfe21d94a42ba0dcf110c88bd884ccd29eeb4fe0f5a9d3ce9e0ea82c", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 14, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-date | controlType: inlineDate | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-date\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"date\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por data exata de evento\",\n \"examplePrompts\": [\n \"crie um filtro inline de data de abertura\",\n \"adicione inlineDate para vencimento\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"dueDate\",\n \"label\": \"Data limite\",\n \"placeholder\": \"dd/mm/aaaa\",\n \"controlType\": \"inlineDate\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de data limite\"\n },\n \"minDate\": \"2024-01-01\",\n \"maxDate\": \"2026-12-31\",\n \"startView\": \"month\",\n \"datepickerTogglePosition\": \"suffix\",\n \"ariaLabel\": \"Filtro de data limite\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-date.json", "contentHash": "7df289c0468a83f740b907ecde67375be2564038e4e9d1134ea256d639dda965", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 15, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-distance-radius | controlType: inlineDistanceRadius | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-distance-radius\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"distance\",\n \"radius\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por raio de distancia com alternancia de unidade km/mi\",\n \"examplePrompts\": [\n \"crie um filtro inline de raio de distancia\",\n \"adicione inlineDistanceRadius para busca geoespacial\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"distanceRadius\",\n \"label\": \"Raio de distancia\",\n \"placeholder\": \"Selecione o raio\",\n \"controlType\": \"inlineDistanceRadius\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"mode\": \"range\",\n \"min\": 1,\n \"max\": 150,\n \"step\": 1,\n \"distanceUnit\": \"km\",\n \"distanceBaseUnit\": \"km\",\n \"distanceAllowUnitToggle\": true,\n \"distanceSubtitle\": \"Visualizacao radial com controle de raio e unidade\",\n \"distancePresets\": [5, 10, 25, 50, 100],\n \"distanceRadialRings\": 5,\n \"distanceAccentColor\": \"#3f5be6\",\n \"inlineAutoSize\": {\n \"minWidth\": 188,\n \"maxWidth\": 360,\n \"panelMinWidth\": 340,\n \"panelMaxWidth\": 560\n },\n \"ariaLabel\": \"Filtro de raio de distancia\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-distance-radius.json", "contentHash": "00f2655d72b44f7ecdae2d35ac63a5bd6b0be58b68be7a141ed055d95df6f795", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 16, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-entity-lookup | controlType: inlineEntityLookup | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-entity-lookup\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"entity-lookup\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por entidades corporativas com identidade padronizada\",\n \"examplePrompts\": [\n \"crie um filtro inline de responsavel\",\n \"adicione inlineEntityLookup para usuario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"ownerId\",\n \"label\": \"Responsavel\",\n \"placeholder\": \"Nome, email ou matricula\",\n \"controlType\": \"inlineEntityLookup\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de responsavel\"\n },\n \"resourcePath\": \"/api/identity/users/options\",\n \"optionLabelKey\": \"displayName\",\n \"optionValueKey\": \"id\",\n \"displayField\": \"displayName\",\n \"valueField\": \"id\",\n \"searchable\": true,\n \"loadOn\": \"focus\",\n \"queryParams\": {\n \"onlyActive\": true\n },\n \"ariaLabel\": \"Filtro de responsavel por lookup corporativo\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-entity-lookup.json", "contentHash": "1cb6821413f7fdea9154dbaee5b874a047a1a9ba987a4c0c2a632202ce8580e1", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 17, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-input | controlType: inlineInput | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"text\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por texto livre com aplicacao recorrente em listas\",\n \"examplePrompts\": [\n \"crie um filtro inline de texto para buscar cliente\",\n \"adicione inlineInput para pesquisa rapida\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"searchTerm\",\n \"label\": \"Buscar\",\n \"placeholder\": \"Cliente, ticket ou protocolo\",\n \"controlType\": \"inlineInput\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de buscar\"\n },\n \"hint\": \"Aceita trechos do nome, codigo ou documento\",\n \"debounceTime\": 250,\n \"minLength\": 2,\n \"maxLength\": 120,\n \"ariaLabel\": \"Filtro de busca textual\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-input.json", "contentHash": "3268c9963e72d11766a2a8bab5e8adc934696812d3754754a7344f99ca27fccc", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 18, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-multi-select | controlType: inlineMultiSelect | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-multi-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"multi-select\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por multiplos valores no mesmo criterio\",\n \"examplePrompts\": [\n \"crie um filtro inline multi-select de canal\",\n \"adicione inlineMultiSelect para tags\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"channels\",\n \"label\": \"Canais\",\n \"placeholder\": \"Selecionar canais\",\n \"controlType\": \"inlineMultiSelect\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de canais\"\n },\n \"multiple\": true,\n \"searchable\": true,\n \"selectAll\": true,\n \"options\": [\n {\n \"key\": \"Web\",\n \"value\": \"web\"\n },\n {\n \"key\": \"Mobile\",\n \"value\": \"mobile\"\n },\n {\n \"key\": \"Loja fisica\",\n \"value\": \"store\"\n },\n {\n \"key\": \"Parceiros\",\n \"value\": \"partners\"\n }\n ],\n \"emptyOptionText\": \"Todos os canais\",\n \"ariaLabel\": \"Filtro multi-select de canais\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-multi-select.json", "contentHash": "43d2a8cfde9af2d289066c11c1137f0bdc25a8012f0f447dc89a57c440aaecdf", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 19, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-number | controlType: inlineNumber | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-number\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"number\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por valores numericos com faixas simples\",\n \"examplePrompts\": [\n \"crie um inlineNumber para score minimo\",\n \"adicione filtro numerico inline para prioridade\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"priorityScore\",\n \"label\": \"Score minimo\",\n \"placeholder\": \"0\",\n \"controlType\": \"inlineNumber\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de score minimo\"\n },\n \"min\": 0,\n \"max\": 100,\n \"step\": 1,\n \"inputMode\": \"numeric\",\n \"ariaLabel\": \"Filtro numerico de score\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-number.json", "contentHash": "3ea645f345c25cc7a005ba2ccd02ea9b50d71cc2fd92450f238e87314e8c6c9a", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 20, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-phone | controlType: inlinePhone | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-phone\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"text\",\n \"phone\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar listas por telefone de contato preservando teclado tel e mascara visual\",\n \"examplePrompts\": [\n \"crie um filtro inline de telefone para contatos\",\n \"adicione inlinePhone para buscar por telefone\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"telefone\",\n \"label\": \"Telefone\",\n \"placeholder\": \"(11) 97100-0470\",\n \"controlType\": \"inlinePhone\",\n \"prefixIcon\": \"phone\",\n \"phoneFormat\": \"national\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de telefone\"\n },\n \"hint\": \"Preserva somente digitos no valor enviado pelo filtro\",\n \"debounceTime\": 250,\n \"minLength\": 8,\n \"maxLength\": 15,\n \"ariaLabel\": \"Filtro de telefone\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-phone.json", "contentHash": "15972ec318503b09b01013afa2e8bdb01922937594d000d53a35cf0758958ead", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 21, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-pipeline-status | controlType: inlinePipelineStatus | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-pipeline-status\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline\",\n \"pipeline\",\n \"status\",\n \"multiselect\"\n ],\n \"useWhen\": \"filtrar por estagios de funil ou status com selecao multipla e distribuicao visual\",\n \"avoidWhen\": \"o dominio usa enum simples de status sem jornada operacional real por etapas\",\n \"examplePrompts\": [\n \"crie um filtro inline de pipeline de status\",\n \"adicione inlinePipelineStatus para etapas comerciais\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"pipelineStatus\",\n \"label\": \"Pipeline de Status\",\n \"placeholder\": \"Selecione estagios\",\n \"controlType\": \"inlinePipelineStatus\",\n \"multiple\": true,\n \"pipelineSubtitle\": \"Funil visual de estagios com selecao multipla\",\n \"pipelineShowSelectionPills\": true,\n \"pipelineShowSelectAll\": true,\n \"pipelineSelectAllText\": \"Selecionar todos\",\n \"pipelineClearActionText\": \"Limpar filtro\",\n \"pipelineSearchable\": true,\n \"pipelineOptionSubtitleKey\": \"count\",\n \"pipelineOptionWeightKey\": \"weight\",\n \"pipelineOptionColorKey\": \"color\",\n \"pipelineOptions\": [\n { \"id\": \"draft\", \"label\": \"Rascunho\", \"value\": \"draft\", \"color\": \"#64748b\", \"count\": 12, \"weight\": 12 },\n { \"id\": \"sent\", \"label\": \"Enviado\", \"value\": \"sent\", \"color\": \"#0ea5e9\", \"count\": 28, \"weight\": 28 },\n { \"id\": \"analysis\", \"label\": \"Em analise\", \"value\": \"analysis\", \"color\": \"#f59e0b\", \"count\": 45, \"weight\": 45 },\n { \"id\": \"approved\", \"label\": \"Aprovado\", \"value\": \"approved\", \"color\": \"#22c55e\", \"count\": 32, \"weight\": 32 },\n { \"id\": \"rejected\", \"label\": \"Rejeitado\", \"value\": \"rejected\", \"color\": \"#ef4444\", \"count\": 8, \"weight\": 8 }\n ],\n \"pipelineTexts\": {\n \"selectionActionsAriaLabel\": \"Acoes de filtro do pipeline\",\n \"barAriaSelected\": \"{label} com {count} status selecionados\"\n },\n \"clearButton\": { \"enabled\": true, \"showOnlyWhenFilled\": true },\n \"ariaLabel\": \"Filtro de pipeline por status\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-pipeline-status.json", "contentHash": "e94c75a5ed66ce0a8e22a0d1386d77ce7a0242617f3ed07eff8a9710e25338f2", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 22, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-range-slider | controlType: inlineRange | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-range-slider\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"range-slider\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por intervalo numerico continuo em UX compacta\",\n \"examplePrompts\": [\n \"crie um filtro inline de faixa percentual\",\n \"adicione inlineRange para score de risco\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"riskRange\",\n \"label\": \"Risco (%)\",\n \"placeholder\": \"0 a 100\",\n \"controlType\": \"inlineRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"min\": 0,\n \"max\": 100,\n \"step\": 5,\n \"thumbLabel\": true,\n \"showTicks\": true,\n \"defaultValue\": {\n \"start\": 20,\n \"end\": 80\n },\n \"ariaLabel\": \"Filtro de faixa percentual de risco\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-range-slider.json", "contentHash": "d893a6155cad8d3f8fde2e707cd894aa62f01a2566c67bbe1fdc633efd29497f", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 23, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-rating | controlType: inlineRating | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-rating\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"rating\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por faixa de avaliacao com estrelas em UX compacta\",\n \"examplePrompts\": [\n \"crie um filtro inline para faixa de rating\",\n \"adicione inlineRating para nota de satisfacao\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"ratingRange\",\n \"label\": \"Avaliacao\",\n \"placeholder\": \"1 a 5\",\n \"controlType\": \"inlineRating\",\n \"prefixIcon\": \"grade\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"min\": 1,\n \"max\": 5,\n \"allowHalf\": true,\n \"ratingToneLowColor\": \"#ef4444\",\n \"ratingToneMidColor\": \"#f59e0b\",\n \"ratingToneHighColor\": \"#22a45d\",\n \"ratingBadgeColor\": \"#f59e0b\",\n \"defaultValue\": {\n \"start\": 1,\n \"end\": 5\n },\n \"showInputs\": false,\n \"inlineAutoSize\": {\n \"minWidth\": 182,\n \"maxWidth\": 340,\n \"panelMinWidth\": 320,\n \"panelMaxWidth\": 520\n },\n \"ariaLabel\": \"Filtro de faixa de avaliacao\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-rating.json", "contentHash": "fbb0e4bb9504e70bcdbd743f083b509570ab21ecf18232be00782c325c7f4fe3", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 24, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-relative-period | controlType: inlineRelativePeriod | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-relative-period\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"relative-period\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por atalhos temporais com normalizacao canonica do backend, como hoje, ultimos 7 dias e este mes\",\n \"avoidWhen\": \"a API nao normaliza presets relativos ou o time precisa rastrear datas finais explicitamente\",\n \"examplePrompts\": [\n \"crie um filtro inline de periodo relativo para dashboard analitico\",\n \"adicione inlineRelativePeriod para atalhos temporais canonicos\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"periodPreset\",\n \"label\": \"Periodo relativo\",\n \"placeholder\": \"Selecionar preset\",\n \"controlType\": \"inlineRelativePeriod\",\n \"relativePeriodShowProgress\": true,\n \"relativePeriodOptions\": [\n { \"id\": \"today\", \"label\": \"Hoje\", \"value\": \"today\", \"icon\": \"calendar_today\" },\n { \"id\": \"yesterday\", \"label\": \"Ontem\", \"value\": \"yesterday\", \"icon\": \"keyboard_double_arrow_left\" },\n { \"id\": \"last7\", \"label\": \"Ultimos 7 dias\", \"value\": \"last7\", \"icon\": \"date_range\" },\n { \"id\": \"last30\", \"label\": \"Ultimos 30 dias\", \"value\": \"last30\", \"icon\": \"event_repeat\" },\n { \"id\": \"thisMonth\", \"label\": \"Este mes\", \"value\": \"thisMonth\", \"icon\": \"event\" }\n ],\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de periodo relativo\"\n },\n \"ariaLabel\": \"Filtro de periodo relativo\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-relative-period.json", "contentHash": "7bc1477eae9182e2e3abb0dc88d1ce36497b15dba9cb310af19f821b309e7f96", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 25, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-score-priority | controlType: inlineScorePriority | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-score-priority\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline\",\n \"score\",\n \"priority\",\n \"range\"\n ],\n \"useWhen\": \"filtrar por faixa de score severidade ou prioridade operacional\",\n \"examplePrompts\": [\n \"crie um filtro inline de score por severidade\",\n \"adicione inlineScorePriority com range de prioridade\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"priorityScore\",\n \"label\": \"Score / Prioridade\",\n \"placeholder\": \"Defina a faixa\",\n \"controlType\": \"inlineScorePriority\",\n \"mode\": \"range\",\n \"min\": 0,\n \"max\": 10,\n \"step\": 1,\n \"scoreBands\": [\n { \"id\": \"low\", \"label\": \"Baixo\", \"color\": \"#16a34a\", \"start\": 0, \"end\": 2.5 },\n { \"id\": \"medium\", \"label\": \"Medio\", \"color\": \"#f59e0b\", \"start\": 2.5, \"end\": 5 },\n { \"id\": \"high\", \"label\": \"Alto\", \"color\": \"#0ea5e9\", \"start\": 5, \"end\": 7.5 },\n { \"id\": \"critical\", \"label\": \"Critico\", \"color\": \"#ef4444\", \"start\": 7.5, \"end\": 10 }\n ],\n \"scoreShowBandChips\": true,\n \"scoreShowScaleLabels\": true,\n \"scoreRangeSeparator\": \"ate\",\n \"scoreBandsAriaLabel\": \"Faixas de severidade\",\n \"scoreBandAriaLabelTemplate\": \"{label}: de {start} ate {end}\",\n \"scoreValueFallbackColor\": \"#334155\",\n \"scorePalette\": [\"#16a34a\", \"#f59e0b\", \"#0ea5e9\", \"#ef4444\"],\n \"scoreTexts\": {\n \"panelSubtitle\": \"Escala configuravel para risco operacional\",\n \"bandsAriaLabel\": \"Faixas de risco\"\n },\n \"defaultValue\": { \"start\": 3, \"end\": 8 },\n \"clearButton\": { \"enabled\": true, \"showOnlyWhenFilled\": true },\n \"ariaLabel\": \"Filtro de score por prioridade\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-score-priority.json", "contentHash": "2b63960042c0eb31b9fd43d412881537584e2df29b6e1ee3860042488fcc8931", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 26, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-searchable-select | controlType: inlineSearchableSelect | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-searchable-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"searchable-select\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por listas medias com busca local\",\n \"examplePrompts\": [\n \"crie um filtro inline buscavel de projeto\",\n \"adicione inlineSearchableSelect na toolbar\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"project\",\n \"label\": \"Projeto\",\n \"placeholder\": \"Buscar projeto\",\n \"controlType\": \"inlineSearchableSelect\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de projeto\"\n },\n \"searchable\": true,\n \"options\": [\n {\n \"key\": \"Portal Corporativo\",\n \"value\": \"portal\"\n },\n {\n \"key\": \"CRM Vendas\",\n \"value\": \"crm-sales\"\n },\n {\n \"key\": \"Ops Financeiro\",\n \"value\": \"ops-finance\"\n },\n {\n \"key\": \"Backoffice RH\",\n \"value\": \"rh-backoffice\"\n }\n ],\n \"emptyOptionText\": \"Todos os projetos\",\n \"ariaLabel\": \"Filtro buscavel de projeto\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-searchable-select.json", "contentHash": "93b51b64114153b943ded7fa4cea8e62d28ddf819c14f9749dbb3f56e5016067", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 27, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-select | controlType: inlineSelect | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"select\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por status ou categoria com lista curta\",\n \"examplePrompts\": [\n \"crie um filtro inline de status\",\n \"adicione inlineSelect para categoria principal\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"status\",\n \"label\": \"Status\",\n \"placeholder\": \"Selecionar\",\n \"controlType\": \"inlineSelect\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de status\"\n },\n \"options\": [\n {\n \"key\": \"Aberto\",\n \"value\": \"open\"\n },\n {\n \"key\": \"Em analise\",\n \"value\": \"triage\"\n },\n {\n \"key\": \"Concluido\",\n \"value\": \"done\"\n }\n ],\n \"emptyOptionText\": \"Todos os status\",\n \"ariaLabel\": \"Filtro de status\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-select.json", "contentHash": "09ff4943d73c508230d9909d394ca6a27da92460e8407e950b5c5db435c92085", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 28, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-sentiment | controlType: inlineSentiment | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-sentiment\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"sentiment\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por polaridade ou humor quando texto e semantica visual se reforcam\",\n \"avoidWhen\": \"o dominio usa apenas enum simples e a interface dependeria de emoji ou cor para ser entendida\",\n \"examplePrompts\": [\n \"crie um filtro inline de sentimento\",\n \"adicione inlineSentiment para classificar humor do atendimento\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"sentiment\",\n \"label\": \"Sentimento\",\n \"placeholder\": \"Selecionar sentimento\",\n \"controlType\": \"inlineSentiment\",\n \"sentimentOptions\": [\n { \"id\": \"bad\", \"label\": \"Ruim\", \"value\": \"bad\", \"emoji\": \":(\", \"color\": \"#f59e0b\" },\n { \"id\": \"neutral\", \"label\": \"Neutro\", \"value\": \"neutral\", \"emoji\": \":|\", \"color\": \"#9ca3af\" },\n { \"id\": \"good\", \"label\": \"Bom\", \"value\": \"good\", \"emoji\": \":)\", \"color\": \"#22c55e\" }\n ],\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true\n },\n \"ariaLabel\": \"Filtro de sentimento\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-sentiment.json", "contentHash": "5fa673d42d45ce8303a18638d222ce8f8ba43c495f5450240b314d7bda52b4b9", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 29, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-time-range | controlType: inlineTimeRange | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-time-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"time-range\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por janela de horario de operacao\",\n \"examplePrompts\": [\n \"crie um filtro inline de faixa horaria\",\n \"adicione inlineTimeRange para turno\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"serviceWindow\",\n \"label\": \"Janela horaria\",\n \"placeholder\": \"08:00 - 18:00\",\n \"controlType\": \"inlineTimeRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de janela horaria\"\n },\n \"defaultValue\": {\n \"start\": \"08:00\",\n \"end\": \"18:00\"\n },\n \"stepMinute\": 15,\n \"validators\": {\n \"minDistance\": 30,\n \"maxDistance\": 720\n },\n \"inlineTimeTrackShifts\": [\n {\n \"id\": \"manha\",\n \"label\": \"Manha\",\n \"start\": \"06:00\",\n \"end\": \"12:00\"\n },\n {\n \"id\": \"comercial\",\n \"label\": \"Comercial\",\n \"start\": \"09:00\",\n \"end\": \"18:00\"\n },\n {\n \"id\": \"noturno\",\n \"label\": \"Noturno\",\n \"start\": \"18:00\",\n \"end\": \"23:00\"\n }\n ],\n \"ariaLabel\": \"Filtro de janela horaria\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-time-range.json", "contentHash": "126cd476edb9326d8d8629c6a34e3fe9dcf864eca49bda4ff65e06b0d92f6a58", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 30, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-time | controlType: inlineTime | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-time\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"time\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por horario pontual dentro da jornada\",\n \"examplePrompts\": [\n \"crie um filtro inline de horario\",\n \"adicione inlineTime para hora de atendimento\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"startTime\",\n \"label\": \"Horario\",\n \"placeholder\": \"HH:mm\",\n \"controlType\": \"inlineTime\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de horario\"\n },\n \"stepMinute\": 15,\n \"defaultValue\": \"09:00\",\n \"ariaLabel\": \"Filtro de horario\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-time.json", "contentHash": "c68443bafd14e74c13ba7fb01809e6630a554df5c1fe713c8512658bb58bb07e", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 31, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-toggle | controlType: inlineToggle | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-toggle\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"toggle\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar condicoes binarias do tipo sim/nao\",\n \"examplePrompts\": [\n \"crie um filtro inline booleano\",\n \"adicione inlineToggle para somente ativos\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"onlyActive\",\n \"label\": \"Somente ativos\",\n \"placeholder\": \"Ativo\",\n \"controlType\": \"inlineToggle\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"defaultValue\": true,\n \"ariaLabel\": \"Filtro somente ativos\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-toggle.json", "contentHash": "81c910b16ec6f4175af3b18dab276da9eadbce5c04fa698c2c44a8a294b2dd96", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 32, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-inline-tree-select | controlType: inlineTreeSelect | inline-filter example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-inline-tree-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"inline-filter\",\n \"tree-select\",\n \"toolbar\"\n ],\n \"useWhen\": \"filtrar por hierarquia de dominio, area e subarea com selecao unica e arvore curta\",\n \"avoidWhen\": \"a arvore eh profunda, exige exploracao de varios ramos ou a decisao depende de revisar a estrutura completa\",\n \"examplePrompts\": [\n \"crie um filtro inline de arvore para departamentos\",\n \"adicione inlineTreeSelect para estrutura organizacional\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"departmentPath\",\n \"label\": \"Departamento\",\n \"placeholder\": \"Selecionar no\",\n \"controlType\": \"inlineTreeSelect\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de departamento\"\n },\n \"options\": [\n {\n \"key\": \"Operacoes\",\n \"value\": \"ops\",\n \"children\": [\n {\n \"key\": \"Atendimento\",\n \"value\": \"ops-support\"\n },\n {\n \"key\": \"Logistica\",\n \"value\": \"ops-logistics\"\n }\n ]\n },\n {\n \"key\": \"Tecnologia\",\n \"value\": \"tech\",\n \"children\": [\n {\n \"key\": \"Plataforma\",\n \"value\": \"tech-platform\"\n },\n {\n \"key\": \"Aplicacoes\",\n \"value\": \"tech-apps\"\n }\n ]\n }\n ],\n \"treeConfig\": {\n \"childrenField\": \"children\",\n \"labelField\": \"key\",\n \"valueField\": \"value\"\n },\n \"ariaLabel\": \"Filtro hierarquico de departamento\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-inline-tree-select.json", "contentHash": "842417abc407df0ad21ccfd4fc6c4334da81b96f0ae8131ecfa3dd4e1f0f2345", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 33, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-async-select | controlType: async-select\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-async-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"base\"\n ],\n \"useWhen\": \"criar campo async-select\",\n \"examplePrompts\": [\n \"crie um campo async-select\",\n \"adicione um async-select ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_async_select\",\n \"label\": \"Example async-select\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"async-select\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"loadOn\": \"open\",\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n },\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-async-select.json", "contentHash": "20f78cec3401b17185b4d7103ecbd090f02323887b0e070ea75937efff9aa66c", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 34, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-autocomplete | controlType: autoComplete\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-autocomplete\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo autoComplete\",\n \"examplePrompts\": [\n \"crie um campo autoComplete\",\n \"adicione um autoComplete ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_autoComplete\",\n \"label\": \"Example autoComplete\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"autoComplete\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"loadOn\": \"open\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-autocomplete.json", "contentHash": "f07fbd110542ce2b6aab0f7b157b45314646daea9d90dbd98a1cc16920bffff2", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 35, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-avatar | controlType: avatar\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-avatar\",\n \"tags\": [\n \"dynamic-fields\",\n \"action\"\n ],\n \"useWhen\": \"criar campo avatar\",\n \"examplePrompts\": [\n \"crie um campo avatar\",\n \"adicione um avatar ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_avatar\",\n \"label\": \"Example avatar\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"avatar\",\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"extra\": {\n \"imageSrc\": \"https://picsum.photos/200\",\n \"imageAlt\": \"Avatar\",\n \"initials\": \"AB\",\n \"name\": \"Ana Brasil\",\n \"icon\": \"mi:person\",\n \"defaultIcon\": \"mi:person_outline\",\n \"themeColor\": \"primary\",\n \"rounded\": \"full\",\n \"size\": \"medium\",\n \"fillMode\": \"solid\",\n \"border\": false,\n \"tooltip\": \"Avatar\",\n \"ariaLabel\": \"Avatar do usuario\"\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-avatar.json", "contentHash": "74668d15dec4337063c5c317488be572479578ecb9a50b1a566262fe50f7a555", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 36, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-button-toggle | controlType: buttonToggle\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-button-toggle\",\n \"tags\": [\n \"dynamic-fields\",\n \"action\"\n ],\n \"useWhen\": \"criar campo buttonToggle\",\n \"examplePrompts\": [\n \"crie um campo buttonToggle\",\n \"adicione um buttonToggle ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_buttonToggle\",\n \"label\": \"Example buttonToggle\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"buttonToggle\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-button-toggle.json", "contentHash": "c2a47f3aa2728997ba1545e0dd74bd329c733f0baf79a798fd15cd0edb7e48a2", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 37, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-button | controlType: button\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-button\",\n \"tags\": [\n \"dynamic-fields\",\n \"action\"\n ],\n \"useWhen\": \"criar campo button\",\n \"examplePrompts\": [\n \"crie um campo button\",\n \"adicione um button ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_button\",\n \"label\": \"Example button\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"button\",\n \"materialDesign\": {\n \"color\": \"primary\"\n },\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"disabled\": true,\n \"ariaLabel\": \"example\",\n \"icon\": \"example\",\n \"variant\": \"raised\",\n \"loading\": true,\n \"action\": \"example\",\n \"disableRipple\": true\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-button.json", "contentHash": "34ff28c90d509e5bf9a8b05da15223c480f76f1cb5a72ce8e407eef6bb174668", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 38, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-checkbox-group | controlType: checkbox\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-checkbox-group\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo checkbox\",\n \"examplePrompts\": [\n \"crie um campo checkbox\",\n \"adicione um checkbox ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_checkbox\",\n \"label\": \"Example checkbox\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"checkbox\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-checkbox-group.json", "contentHash": "2a966b534978a30b49051951b402a80813c02e0930caae0e82090c35d2cb073f", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 39, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-chips | controlType: chipInput | aliases: chipList\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-chips\",\n \"tags\": [\n \"dynamic-fields\",\n \"base\"\n ],\n \"useWhen\": \"criar campo chipInput\",\n \"examplePrompts\": [\n \"crie um campo chipInput\",\n \"adicione um chipInput ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_chipInput\",\n \"label\": \"Example chipInput\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"chipInput\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-chips.json", "contentHash": "4bb1b721830dc30c0e1ed6a6396085dbb46a89e3211699c0b719d5902f748fab", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 40, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-colorpicker | controlType: colorPicker\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-colorpicker\",\n \"tags\": [\n \"dynamic-fields\",\n \"color\"\n ],\n \"useWhen\": \"criar campo material colorpicker\",\n \"examplePrompts\": [\n \"crie um campo material colorpicker\",\n \"adicione um material colorpicker ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_material_colorpicker\",\n \"label\": \"Example material colorpicker\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"colorPicker\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"format\": \"hex\",\n \"showAlpha\": true,\n \"presetColors\": [\n \"#ff0000\",\n \"#00ff00\"\n ],\n \"allowCustomColors\": true,\n \"variant\": \"default\",\n \"showInput\": true,\n \"showPreview\": true,\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"views\": [\n \"gradient\"\n ],\n \"activeView\": \"gradient\",\n \"preview\": true,\n \"clearButton\": true,\n \"actionsLayout\": \"start\",\n \"adaptiveMode\": true,\n \"adaptiveTitle\": \"example\",\n \"adaptiveSubtitle\": \"example\",\n \"popupSettings\": {\n \"example\": true\n },\n \"gradientSettings\": {\n \"example\": true\n },\n \"paletteSettings\": {\n \"example\": true\n },\n \"fillMode\": \"solid\",\n \"rounded\": \"none\",\n \"size\": \"small\",\n \"icon\": \"example\",\n \"iconClass\": \"example\",\n \"svgIcon\": \"example\",\n \"tabindex\": 1\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-colorpicker.json", "contentHash": "1e529e184da07e4280094ef35963a8ee9f683e7e6a01301e93b35d7d4a69c7d6", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 41, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-cpf-cnpj-input | controlType: cpfCnpjInput\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-cpf-cnpj-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"brazil\"\n ],\n \"useWhen\": \"criar campo cpfCnpjInput\",\n \"examplePrompts\": [\n \"crie um campo cpfCnpjInput\",\n \"adicione um cpfCnpjInput ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_cpfCnpjInput\",\n \"label\": \"Example cpfCnpjInput\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"cpfCnpjInput\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"cpf\": true,\n \"cnpj\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"text\",\n \"maskType\": \"cpf\",\n \"unmaskOnSubmit\": true\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-cpf-cnpj-input.json", "contentHash": "495ef7b725ab8ca2b83faa456653fd877238b9cdb06ee5f09adccf5ba46afffa", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 42, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-currency | controlType: currency\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-currency\",\n \"tags\": [\n \"dynamic-fields\",\n \"numeric\"\n ],\n \"useWhen\": \"criar campo currency\",\n \"examplePrompts\": [\n \"crie um campo currency\",\n \"adicione um currency ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_currency\",\n \"label\": \"Example currency\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"currency\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"currency\": \"BRL\",\n \"currencyPosition\": \"before\",\n \"decimalPlaces\": 2,\n \"locale\": \"pt-BR\",\n \"thousandsSeparator\": \".\",\n \"decimalSeparator\": \",\",\n \"allowNegative\": false\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-currency.json", "contentHash": "d8f04ca04375bec89dd1f6c9788a9d93b72e7dc9c2c6adea2782e2ddbcaa96a0", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 43, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-date-range | controlType: dateRange | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-date-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"date-range\"\n ],\n \"useWhen\": \"filtrar ou cadastrar período de início e fim\",\n \"examplePrompts\": [\n \"crie um campo dateRange para período\",\n \"adicione dateRange para janela de criação\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"createdAtRange\",\n \"label\": \"Período de criação\",\n \"placeholder\": \"Início até Fim\",\n \"controlType\": \"dateRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de período de criação\"\n },\n \"rangeSeparator\": \"até\",\n \"startPlaceholder\": \"Início\",\n \"endPlaceholder\": \"Fim\",\n \"minDate\": \"2024-01-01\",\n \"maxDate\": \"2026-12-31\",\n \"ariaLabel\": \"Seletor de período de datas\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-date-range.json", "contentHash": "d26b1b9500a7b6560a3d8bb17c0aa7a5cb7a58ee6451f8ab47ea2679a1289eb4", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 44, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-datepicker | controlType: date | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-datepicker\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"material-datepicker\"\n ],\n \"useWhen\": \"escolher datas com contexto visual de calendário\",\n \"examplePrompts\": [\n \"crie um campo date com calendário\",\n \"adicione material datepicker para data limite\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"dueDate\",\n \"label\": \"Data limite\",\n \"placeholder\": \"dd/mm/aaaa\",\n \"controlType\": \"date\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de data limite\"\n },\n \"minDate\": \"2024-01-01\",\n \"maxDate\": \"2026-12-31\",\n \"startView\": \"month\",\n \"touchUi\": false,\n \"datepickerTogglePosition\": \"suffix\",\n \"ariaLabel\": \"Seletor de data limite\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-datepicker.json", "contentHash": "7830baa3816f63cb1f7dfde5e7769a12f48c21cb863d8c68875deeace4370451", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 45, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-file-upload | controlType: upload\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-file-upload\",\n \"tags\": [\n \"dynamic-fields\",\n \"file\"\n ],\n \"useWhen\": \"criar campo upload\",\n \"examplePrompts\": [\n \"crie um campo upload\",\n \"adicione um upload ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_upload\",\n \"label\": \"Example upload\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"upload\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-file-upload.json", "contentHash": "cc4867db584db72eae9306adb0f9dbe7348783c770ae7915d082478c7e0994f2", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 46, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-multi-select-tree | controlType: multiSelectTree\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-multi-select-tree\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo multiSelectTree\",\n \"examplePrompts\": [\n \"crie um campo multiSelectTree\",\n \"adicione um multiSelectTree ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_multiSelectTree\",\n \"label\": \"Example multiSelectTree\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"multiSelectTree\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-multi-select-tree.json", "contentHash": "e64264fb424d7e519b5ef338b58a99bedf718203a154c3fbe5c7cba4c55cb185", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 47, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-multi-select | controlType: multiSelect\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-multi-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo multiSelect\",\n \"examplePrompts\": [\n \"crie um campo multiSelect\",\n \"adicione um multiSelect ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_multiSelect\",\n \"label\": \"Example multiSelect\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"multiSelect\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-multi-select.json", "contentHash": "67a4cb25abf4fa3e671d964f1cffe028120b7f0c68bdc9e85a50717a7a5c026b", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 48, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-price-range | controlType: priceRange\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-price-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"numeric\"\n ],\n \"useWhen\": \"criar campo priceRange\",\n \"examplePrompts\": [\n \"crie um campo priceRange\",\n \"adicione um priceRange ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_priceRange\",\n \"label\": \"Example priceRange\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"priceRange\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"min\": 1,\n \"max\": 1,\n \"step\": 1,\n \"currency\": \"BRL\",\n \"currencyPosition\": \"before\",\n \"decimalPlaces\": 2,\n \"locale\": \"pt-BR\",\n \"thousandsSeparator\": \".\",\n \"decimalSeparator\": \",\",\n \"allowNegative\": false,\n \"startPlaceholder\": \"Min\",\n \"endPlaceholder\": \"Max\",\n \"startLabel\": \"Min\",\n \"endLabel\": \"Max\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-price-range.json", "contentHash": "90114e0ade8420990f574bc2e97b439827025b08848ba8ac92229b2356de3aa9", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 49, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-radio-group | controlType: radio\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-radio-group\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo radio\",\n \"examplePrompts\": [\n \"crie um campo radio\",\n \"adicione um radio ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_radio\",\n \"label\": \"Example radio\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"radio\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-radio-group.json", "contentHash": "83fccfc58284e49f9ae3311360fb071e4babbc34209db2e36c2708c0821acd88", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 50, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-range-slider | controlType: rangeSlider\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-range-slider\",\n \"tags\": [\"dynamic-fields\", \"numeric\"],\n \"useWhen\": \"criar campo rangeSlider\",\n \"examplePrompts\": [\n \"crie um campo rangeSlider\",\n \"adicione um rangeSlider ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_rangeSlider\",\n \"label\": \"Example rangeSlider\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"rangeSlider\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\"form\"],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\"status\"],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"min\": 1,\n \"max\": 1,\n \"step\": 1,\n \"thumbLabel\": true,\n \"valueLabelDisplay\": \"on\",\n \"valueLabelFormat\": \"compact\",\n \"showTicks\": true,\n \"marks\": [\n {\n \"value\": 0,\n \"label\": \"Min\"\n },\n {\n \"value\": 50,\n \"label\": \"Target\",\n \"tone\": \"info\"\n },\n {\n \"value\": 100,\n \"label\": \"Max\"\n }\n ],\n \"semanticBands\": [\n {\n \"start\": 0,\n \"end\": 40,\n \"label\": \"Low range\",\n \"tone\": \"success\"\n },\n {\n \"start\": 40,\n \"end\": 75,\n \"label\": \"Target range\",\n \"tone\": \"info\"\n },\n {\n \"start\": 75,\n \"end\": 100,\n \"label\": \"High range\",\n \"tone\": \"danger\"\n }\n ],\n \"distribution\": {\n \"colorMode\": \"gradient\",\n \"gradientStartColor\": \"var(--md-sys-color-primary)\",\n \"gradientEndColor\": \"var(--md-sys-color-tertiary)\",\n \"bins\": [3, 9, 16, 11, 5],\n \"maxValue\": 16\n },\n \"track\": \"normal\",\n \"size\": \"medium\",\n \"vertical\": true,\n \"invert\": true\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-range-slider.json", "contentHash": "2c1e55d7ad04f9c0a2112663c6869f106926f948d0370aac59a265dfa132c316", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 51, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-rating | controlType: rating\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-rating\",\n \"tags\": [\n \"dynamic-fields\",\n \"action\"\n ],\n \"useWhen\": \"criar campo rating\",\n \"examplePrompts\": [\n \"crie um campo rating\",\n \"adicione um rating ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_rating\",\n \"label\": \"Example rating\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"rating\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"icon\": \"example\",\n \"color\": \"primary\",\n \"size\": \"small\",\n \"max\": 1,\n \"allowHalf\": true,\n \"emptyIcon\": \"mi:star_border\",\n \"selection\": \"continuous\",\n \"ratingColor\": \"#fbc02d\",\n \"outlineColor\": \"rgba(0,0,0,0.38)\",\n \"tabIndex\": 0\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-rating.json", "contentHash": "7fc6ae83c88f6f9b8564d4ec0e3a632fff4afcd80ab9b5194e16fdac457708e6", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 52, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-searchable-select | controlType: searchable-select\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-searchable-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"base\"\n ],\n \"useWhen\": \"criar campo searchable-select\",\n \"examplePrompts\": [\n \"crie um campo searchable-select\",\n \"adicione um searchable-select ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_searchable_select\",\n \"label\": \"Example searchable-select\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"searchable-select\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"loadOn\": \"open\",\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n },\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-searchable-select.json", "contentHash": "bac8907b9dd84a454aaf3089b018e1db97d9229304dab2543201f34925504660", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 53, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-select | controlType: select\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo select\",\n \"examplePrompts\": [\n \"crie um campo select\",\n \"adicione um select ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_select\",\n \"label\": \"Example select\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"select\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-select.json", "contentHash": "a5d63debe4f29f0054012f1d99f93a05b5b32c14b58d3848a89e7a1ddee7554f", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 54, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-selection-list | controlType: selectionList\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-selection-list\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo selectionList\",\n \"examplePrompts\": [\n \"crie um campo selectionList\",\n \"adicione um selectionList ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_selectionList\",\n \"label\": \"Example selectionList\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"selectionList\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-selection-list.json", "contentHash": "fe2aa8dae55be0a1369dea6e8560ba7bf027fed89474dc043b9d187579e7db01", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 55, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-slide-toggle | controlType: toggle\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-slide-toggle\",\n \"tags\": [\n \"dynamic-fields\",\n \"base\"\n ],\n \"useWhen\": \"criar campo toggle\",\n \"examplePrompts\": [\n \"crie um campo toggle\",\n \"adicione um toggle ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_toggle\",\n \"label\": \"Example toggle\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"toggle\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-slide-toggle.json", "contentHash": "1bd94d416385c28ab21d3eec8698a7da9b941a9545aaa1fdaf2b407db5cf10cf", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 56, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-slider | controlType: slider\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-slider\",\n \"tags\": [\"dynamic-fields\", \"numeric\"],\n \"useWhen\": \"criar campo slider\",\n \"examplePrompts\": [\n \"crie um campo slider\",\n \"adicione um slider ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_slider\",\n \"label\": \"Example slider\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"slider\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\"form\"],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\"status\"],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"min\": 1,\n \"max\": 1,\n \"step\": 1,\n \"thumbLabel\": true,\n \"valueLabelDisplay\": \"on\",\n \"valueLabelFormat\": \"percent\",\n \"showTicks\": true,\n \"marks\": [\n {\n \"value\": 0,\n \"label\": \"Low\",\n \"tone\": \"success\"\n },\n {\n \"value\": 50,\n \"label\": \"Target\",\n \"tone\": \"info\"\n },\n {\n \"value\": 100,\n \"label\": \"High\",\n \"tone\": \"danger\"\n }\n ],\n \"semanticBands\": [\n {\n \"start\": 0,\n \"end\": 40,\n \"label\": \"Low risk\",\n \"tone\": \"success\"\n },\n {\n \"start\": 40,\n \"end\": 75,\n \"label\": \"Attention\",\n \"tone\": \"warning\"\n },\n {\n \"start\": 75,\n \"end\": 100,\n \"label\": \"Critical\",\n \"tone\": \"danger\"\n }\n ],\n \"distribution\": {\n \"colorMode\": \"selection\",\n \"bins\": [4, 12, 18, 10, 6]\n },\n \"track\": \"normal\",\n \"size\": \"medium\",\n \"vertical\": true,\n \"invert\": true\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-slider.json", "contentHash": "5a01bdb48e7e5843ca818daf8ed15ab0682552ccf6b1ddc5c8cc6beafc971213", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 57, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-textarea | controlType: textarea\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-textarea\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo textarea\",\n \"examplePrompts\": [\n \"crie um campo textarea\",\n \"adicione um textarea ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_textarea\",\n \"label\": \"Example textarea\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"textarea\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"rows\": 1,\n \"minRows\": 1,\n \"maxRows\": 1,\n \"resize\": \"none\",\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-textarea.json", "contentHash": "d93a30b67e86f303cdef25d9573aea49dec6b9536a1d3e261567486c58db2160", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 58, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-time-range | controlType: timeRange | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-time-range\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"time-range\"\n ],\n \"useWhen\": \"definir janelas horárias com validação de distância\",\n \"examplePrompts\": [\n \"crie um campo timeRange para janela de atendimento\",\n \"adicione timeRange para turno operacional\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"serviceWindow\",\n \"label\": \"Janela de atendimento\",\n \"placeholder\": \"08:00 - 18:00\",\n \"controlType\": \"timeRange\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de janela de atendimento\"\n },\n \"defaultValue\": {\n \"start\": \"08:00\",\n \"end\": \"18:00\"\n },\n \"validators\": {\n \"minDistance\": 30,\n \"maxDistance\": 720\n },\n \"ariaLabel\": \"Seletor de janela horária\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-time-range.json", "contentHash": "b2b0514b7261d0aa08b7232539e09239194119e806b201b70f337889f92f2f2e", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 59, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-timepicker | controlType: timePicker | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-timepicker\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"timepicker\"\n ],\n \"useWhen\": \"escolher horário com apoio visual de picker\",\n \"examplePrompts\": [\n \"crie um campo timePicker para reunião\",\n \"adicione timePicker para horário de corte\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"meetingTime\",\n \"label\": \"Horário da reunião\",\n \"placeholder\": \"HH:mm\",\n \"controlType\": \"timePicker\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de horário da reunião\"\n },\n \"stepMinute\": 15,\n \"enableSeconds\": false,\n \"ariaLabel\": \"Seletor de horário da reunião\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-timepicker.json", "contentHash": "a29674b5cb8ac6a98ff5ee3415f022943675a8be0ca7d8a479aeb39b5deb4543", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 60, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-transfer-list | controlType: transferList\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-transfer-list\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo transferList\",\n \"examplePrompts\": [\n \"crie um campo transferList\",\n \"adicione um transferList ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_transferList\",\n \"label\": \"Example transferList\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"transferList\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-transfer-list.json", "contentHash": "94489d5cd2238e884fa974f6c31d53a77eab13e0decb34921445b24f7b160aa9", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 61, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-material-tree-select | controlType: treeSelect | aliases: treeView\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-material-tree-select\",\n \"tags\": [\n \"dynamic-fields\",\n \"select\"\n ],\n \"useWhen\": \"criar campo treeSelect\",\n \"examplePrompts\": [\n \"crie um campo treeSelect\",\n \"adicione um treeSelect ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_treeSelect\",\n \"label\": \"Example treeSelect\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"treeSelect\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"options\": [\n {\n \"text\": \"Option A\",\n \"value\": \"A\"\n }\n ],\n \"endpoint\": \"/api/options\",\n \"valueField\": \"value\",\n \"displayField\": \"text\",\n \"filterField\": \"query\",\n \"queryParams\": {\n \"status\": \"active\"\n },\n \"cacheDuration\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"status\": \"status\"\n },\n \"dependencyValuePath\": \"id\",\n \"dependencyMergeStrategy\": \"merge\",\n \"dependencyLoadOnChange\": \"immediate\",\n \"enableDependencyCascade\": true,\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 200,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"multiple\": true,\n \"searchable\": true,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"icon\": \"mi:clear\",\n \"iconColor\": \"primary\",\n \"tooltip\": \"Limpar\",\n \"ariaLabel\": \"Limpar\"\n },\n \"selectAll\": true,\n \"maxSelections\": 1,\n \"emptyOptionText\": \"example\",\n \"optionLabelKey\": \"example\",\n \"optionValueKey\": \"example\",\n \"treeConfig\": {\n \"example\": true\n },\n \"resourcePath\": \"example\",\n \"filterCriteria\": {\n \"example\": true\n }\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-material-tree-select.json", "contentHash": "64b52505a270c8cc51a0c7461e8323c61d5f448ff007c2a87648fbc332cdcc7a", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 62, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-month-input | controlType: month | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-month-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"month\"\n ],\n \"useWhen\": \"trabalhar com competência mensal ou fechamento de ciclo\",\n \"examplePrompts\": [\n \"crie um campo month para competência\",\n \"adicione month para fechamento mensal\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"billingMonth\",\n \"label\": \"Competência\",\n \"placeholder\": \"aaaa-mm\",\n \"controlType\": \"month\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de competência\"\n },\n \"min\": \"2024-01\",\n \"max\": \"2026-12\",\n \"ariaLabel\": \"Campo de competência mensal\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-month-input.json", "contentHash": "8f3a7851a739eb54eb4844a83819906da0edf6875636f599e3f12ae3b81fd255", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 63, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-number-input | controlType: numericTextBox\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-number-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"numeric\"\n ],\n \"useWhen\": \"criar campo numericTextBox\",\n \"examplePrompts\": [\n \"crie um campo numericTextBox\",\n \"adicione um numericTextBox ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_numericTextBox\",\n \"label\": \"Example numericTextBox\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"numericTextBox\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"min\": 1,\n \"max\": 1,\n \"step\": 1\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-number-input.json", "contentHash": "87bc4fec83f94bc64c15b440cc3c3f74d9a5c6a5dfe60fb1597f183e485c3581", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 64, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-password-input | controlType: password\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-password-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo password\",\n \"examplePrompts\": [\n \"crie um campo password\",\n \"adicione um password ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_password\",\n \"label\": \"Example password\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"password\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"password\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-password-input.json", "contentHash": "96433f16c49d602b0aaec9c684bbb39e78813a89692e937581e6f37ac1759df1", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 65, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-phone-input | controlType: phone\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-phone-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"phone\",\n \"mask\",\n \"validation\"\n ],\n \"useWhen\": \"criar campo phone com mascara e validacao telefonica por pais\",\n \"examplePrompts\": [\n \"crie um campo phone com mascara brasileira\",\n \"adicione um telefone validado ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"contact_phone\",\n \"label\": \"Telefone de contato\",\n \"placeholder\": \"(11) 98765-4321\",\n \"hint\": \"Informe o telefone com DDD.\",\n \"tooltip\": \"Telefone validado por pais e normalizado em E.164 quando valido.\",\n \"description\": \"Campo telefonico com mascara progressiva e validacao semantica.\",\n \"group\": \"Contato\",\n \"order\": 1,\n \"width\": \"320px\",\n \"isFlex\": true,\n \"controlType\": \"phone\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"mi:call\",\n \"suffixIcon\": \"mi:verified\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"required\": true\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"+5511987654321\",\n \"ariaLabel\": \"Telefone de contato\",\n \"ariaDescribedBy\": \"contact_phone_hint\",\n \"inputType\": \"tel\",\n \"defaultCountry\": \"BR\",\n \"allowedCountries\": [\n \"BR\"\n ],\n \"phoneFormat\": \"national\",\n \"autoFormat\": true,\n \"validatePhoneNumber\": true\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-phone-input.json", "contentHash": "9347254b87ef4bee39a86c2bbe764861f8fddc5cf267d8ccde78a5f9b21b1018", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 66, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-preload-status | utility preload widget\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-preload-status\",\n \"tags\": [\n \"dynamic-fields\",\n \"status\",\n \"utility\"\n ],\n \"useWhen\": \"mostrar status de preload\",\n \"examplePrompts\": [\n \"mostrar status de preload\",\n \"adicione um status de preload no layout\"\n ]\n },\n \"metadata\": {\n \"example\": true\n },\n \"visible\": true\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-preload-status.json", "contentHash": "e2be8b196e33662ee94855b9a5935528723453822a41bdf6b049183f1ca79fde", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 67, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-search-input | controlType: search\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-search-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo search\",\n \"examplePrompts\": [\n \"crie um campo search\",\n \"adicione um search ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_search\",\n \"label\": \"Example search\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"search\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"search\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-search-input.json", "contentHash": "ff73f42cdfa1a84f64d29131c7d2db2578da5616edd3e565c6373d1a8472261c", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 68, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-text-input | controlType: input\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-text-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo input\",\n \"examplePrompts\": [\n \"crie um campo input\",\n \"adicione um input ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_input\",\n \"label\": \"Example input\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"input\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"text\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-text-input.json", "contentHash": "08f6542564caf9493e0165f24966348abc927023483718ec94f5735c91e3f11a", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 69, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-time-input | controlType: time | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-time-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"time\"\n ],\n \"useWhen\": \"capturar horário pontual sem sobrecarga de UI\",\n \"examplePrompts\": [\n \"crie um campo time para horário de início\",\n \"adicione time para corte operacional\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"startTime\",\n \"label\": \"Horário de início\",\n \"placeholder\": \"HH:mm\",\n \"controlType\": \"time\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de horário de início\"\n },\n \"stepMinute\": 15,\n \"ariaLabel\": \"Campo de horário de início\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-time-input.json", "contentHash": "6c937c703eb538c3ddf317ea3ed11408d5584fc34214c363462c7bc6d3e8b1a5", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 70, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-url-input | controlType: url\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-url-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"text\"\n ],\n \"useWhen\": \"criar campo url\",\n \"examplePrompts\": [\n \"crie um campo url\",\n \"adicione um url ao formulario\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"example_url\",\n \"label\": \"Example url\",\n \"placeholder\": \"example\",\n \"hint\": \"example\",\n \"tooltip\": \"example\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"url\",\n \"materialDesign\": {\n \"appearance\": \"fill\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\",\n \"subscriptSizing\": \"fixed\",\n \"hideRequiredMarker\": true,\n \"density\": \"comfortable\",\n \"disableRipple\": true,\n \"customPalette\": {\n \"example\": true\n },\n \"animations\": {\n \"example\": true\n }\n },\n \"prefixIcon\": \"example\",\n \"suffixIcon\": \"example\",\n \"iconPosition\": \"start\",\n \"iconSize\": \"small\",\n \"validators\": {\n \"example\": true,\n \"required\": true,\n \"email\": true,\n \"minLength\": 1,\n \"maxLength\": 1,\n \"min\": 1,\n \"max\": 1,\n \"pattern\": \"example\",\n \"minWords\": 1,\n \"requiredChecked\": true,\n \"patternMessage\": \"example\"\n },\n \"validationMode\": \"immediate\",\n \"debounceTime\": 1,\n \"hidden\": true,\n \"visibleIn\": [\n \"form\"\n ],\n \"formHidden\": true,\n \"tableHidden\": true,\n \"filterHidden\": true,\n \"dependencyFields\": [\n \"status\"\n ],\n \"conditionalRequired\": \"formValue.status == 'active'\",\n \"conditionalDisplay\": \"formValue.status == 'active'\",\n \"dependencyFilterMap\": {\n \"example\": true\n },\n \"dependencyValuePath\": \"example\",\n \"dependencyMergeStrategy\": \"replace\",\n \"dependencyLoadOnChange\": \"respectLoadOn\",\n \"resetOnDependentChange\": true,\n \"dependencyDebounceMs\": 1,\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\",\n \"textTransformApply\": \"displayOnly\",\n \"inlineEditing\": true,\n \"unique\": true,\n \"readOnly\": true,\n \"disabled\": true,\n \"defaultValue\": \"default\",\n \"ariaLabel\": \"example\",\n \"ariaDescribedBy\": \"example\",\n \"inputType\": \"url\",\n \"maxLength\": 1,\n \"minLength\": 1,\n \"pattern\": \"example\",\n \"inputMode\": \"text\",\n \"autocomplete\": \"example\",\n \"spellcheck\": true,\n \"textTransform\": \"uppercase\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-url-input.json", "contentHash": "283ec023952a0427369a9893c71075189c2ae4c868e42c285d63a0ce3c474aa6", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 71, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-week-input | controlType: week | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-week-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"week\"\n ],\n \"useWhen\": \"organizar planejamento por semana operacional\",\n \"examplePrompts\": [\n \"crie um campo week para sprint\",\n \"adicione week para planejamento semanal\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"sprintWeek\",\n \"label\": \"Semana\",\n \"placeholder\": \"aaaa-Www\",\n \"controlType\": \"week\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de semana\"\n },\n \"ariaLabel\": \"Campo de semana operacional\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-week-input.json", "contentHash": "996624f6da91b01243926290d7b51a2f99f4922d52f36f5af51d7b2ebbd26cd4", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 72, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for pdx-year-input | controlType: year | date-time example\",\n \"templateMeta\": {\n \"registryKey\": \"pdx-year-input\",\n \"tags\": [\n \"dynamic-fields\",\n \"date-time\",\n \"year\"\n ],\n \"useWhen\": \"informar ano de referência fiscal ou orçamento\",\n \"examplePrompts\": [\n \"crie um campo year para ano fiscal\",\n \"adicione year para ano de vigência\"\n ]\n },\n \"fieldMetadata\": {\n \"name\": \"fiscalYear\",\n \"label\": \"Ano fiscal\",\n \"placeholder\": \"AAAA\",\n \"controlType\": \"year\",\n \"materialDesign\": {\n \"appearance\": \"outline\",\n \"color\": \"primary\",\n \"floatLabel\": \"auto\"\n },\n \"formHidden\": false,\n \"tableHidden\": true,\n \"filterHidden\": false,\n \"readOnly\": false,\n \"disabled\": false,\n \"clearButton\": {\n \"enabled\": true,\n \"showOnlyWhenFilled\": true,\n \"ariaLabel\": \"Limpar filtro de ano fiscal\"\n },\n \"min\": 2020,\n \"max\": 2035,\n \"ariaLabel\": \"Campo de ano fiscal\"\n }\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/pdx-year-input.json", "contentHash": "cea4a442e0c529601b28921c1af856c03cc35a852d49e4e35edca2d88389ad2b", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" }, { "chunkIndex": 73, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for praxis-field-shell | internal field wrapper\",\n \"templateMeta\": {\n \"registryKey\": \"praxis-field-shell\",\n \"tags\": [\n \"dynamic-fields\",\n \"internal\",\n \"container\"\n ],\n \"useWhen\": \"envolver campo com field shell\",\n \"examplePrompts\": [\n \"envolva um campo com field shell\",\n \"usar field shell no canvas\"\n ]\n },\n \"field\": {\n \"name\": \"example_input\",\n \"label\": \"Example input\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"input\",\n \"hidden\": false,\n \"formHidden\": false,\n \"tableHidden\": false,\n \"filterHidden\": false,\n \"readOnly\": true,\n \"disabled\": false,\n \"inlineEditing\": true,\n \"defaultValue\": \"default\",\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\"\n },\n \"index\": 0,\n \"control\": null,\n \"readonlyMode\": false,\n \"disabledMode\": false,\n \"visible\": true,\n \"presentationMode\": false,\n \"canvasMode\": false,\n \"itemTemplate\": \"exampleItemTemplate\"\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/praxis-field-shell.json", "contentHash": "db3e0aab6d0e50cfaa0347629600ddacb64473677ccbfca6f64660f6f2aa7565", "sourceKind": "component_definition", "sourceId": "praxis-dynamic-fields", "corpusVersion": "1.0.0" } ] }, "praxis-field-shell": { "id": "praxis-field-shell", "description": "Invólucro visual/comportamental para campos dinâmicos (uso interno).", "inputs": [ { "name": "field", "type": "FieldMetadata", "required": false }, { "name": "index", "type": "number", "required": false }, { "name": "control", "type": "AbstractControl | null", "required": false }, { "name": "readonlyMode", "type": "boolean", "required": false }, { "name": "disabledMode", "type": "boolean", "required": false }, { "name": "visible", "type": "boolean", "required": false }, { "name": "presentationMode", "type": "boolean", "required": false }, { "name": "canvasMode", "type": "boolean", "required": false } ], "outputs": [], "configSchemaId": "FieldMetadata", "selector": "praxis-field-shell", "friendlyName": "Field Shell (container)", "icon": "view_day", "tags": [ "internal", "container", "wrapper" ], "lib": "@praxisui/dynamic-fields", "source": "projects/praxis-dynamic-fields/src/lib/components/field-shell/field-shell.metadata.ts", "exportName": "PDX_FIELD_SHELL_COMPONENT_METADATA", "capabilities": [ { "path": "id", "category": "identity", "valueKind": "string", "description": "Identificador unico da instancia do componente.", "intentExamples": [ "id do componente", "definir id fixo" ] }, { "path": "version", "category": "identity", "valueKind": "string", "description": "Versao do schema de metadata (migracao).", "intentExamples": [ "versao do metadata", "ajustar versao" ] }, { "path": "context", "category": "identity", "valueKind": "enum", "allowedValues": [ "form", "filter", "table", "dialog", "standalone" ], "description": "Contexto de uso do componente (form/filter/table/dialog/standalone).", "intentExamples": [ "contexto form", "usar em tabela" ] }, { "path": "createdAt", "category": "misc", "valueKind": "string", "description": "Timestamp de criacao (ISO).", "safetyNotes": "Valor de auditoria; preferir preenchimento pelo host." }, { "path": "updatedAt", "category": "misc", "valueKind": "string", "description": "Timestamp de atualizacao (ISO).", "safetyNotes": "Valor de auditoria; preferir preenchimento pelo host." }, { "path": "tags", "category": "identity", "valueKind": "array", "description": "Tags para categorizacao e busca.", "intentExamples": [ "tag para busca", "categorizar campo" ] }, { "path": "cssClass", "category": "appearance", "valueKind": "string", "description": "Classe CSS aplicada ao host do componente.", "intentExamples": [ "classe custom", "aplicar classe" ] }, { "path": "style", "category": "appearance", "valueKind": "object", "description": "Estilos inline (objeto CSS).", "safetyNotes": "Validar chaves e valores CSS permitidos." }, { "path": "dataAttributes", "category": "data", "valueKind": "object", "description": "Data attributes para teste/analytics.", "intentExamples": [ "data-testid", "atributos de tracking" ] }, { "path": "name", "category": "identity", "valueKind": "string", "description": "Identificador único do campo. Essencial para binding.", "critical": true, "intentExamples": [ "nomear campo como email", "id do campo" ] }, { "path": "label", "category": "identity", "valueKind": "string", "description": "Rótulo principal exibido para o usuário.", "intentExamples": [ "alterar label", "mudar texto do rótulo" ] }, { "path": "placeholder", "category": "identity", "valueKind": "string", "description": "Texto temporário exibido quando vazio.", "intentExamples": [ "adicionar placeholder", "texto de ajuda no input" ] }, { "path": "hint", "category": "identity", "valueKind": "string", "description": "Texto de ajuda exibido abaixo do campo.", "intentExamples": [ "colocar dica", "ajuda no rodapé do campo" ] }, { "path": "helpText", "category": "identity", "valueKind": "string", "description": "Texto semântico de ajuda publicado pelo schema/DTO.", "intentExamples": [ "explicar regra de negócio do campo", "ajuda vinda do backend" ] }, { "path": "tooltip", "category": "identity", "valueKind": "string", "description": "Texto exibido ao passar o mouse.", "intentExamples": [ "adicionar tooltip" ] }, { "path": "tooltipOnHover", "category": "identity", "valueKind": "boolean", "description": "Habilita apresentação do tooltip no hover quando suportado pelo renderer.", "intentExamples": [ "mostrar tooltip ao passar o mouse", "ativar dica no hover" ] }, { "path": "description", "category": "identity", "valueKind": "string", "description": "Descrição detalhada (usada em documentação ou helps extensos).", "intentExamples": [ "descrição completa do campo", "texto explicativo longo", "documentação do input" ] }, { "path": "selectionMode", "category": "behavior", "valueKind": "enum", "allowedValues": [ "boolean", "single", "multiple" ], "description": "Semântica de seleção explícita para controles de escolha.", "intentExamples": [ "checkbox booleano", "radio de escolha única", "grupo múltiplo" ] }, { "path": "variant", "category": "appearance", "valueKind": "string", "description": "Variante visual/semântica do controle.", "intentExamples": [ "variante consent", "modo compact", "apresentação em tiles" ] }, { "path": "density", "category": "appearance", "valueKind": "enum", "allowedValues": [ "compact", "comfortable", "spacious" ], "description": "Densidade visual do shell do controle.", "intentExamples": [ "deixar mais compacto", "usar densidade confortável", "mais espaçado" ] }, { "path": "links", "category": "identity", "valueKind": "array", "description": "Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.", "intentExamples": [ "adicionar link da política", "incluir termos de uso", "anexar link institucional" ] }, { "path": "group", "category": "identity", "valueKind": "string", "description": "Agrupador lógico do campo.", "intentExamples": [ "agrupar em Dados Pessoais", "colocar no grupo de endereço", "categoria do campo" ] }, { "path": "order", "category": "layout", "valueKind": "number", "description": "Ordem de exibição do campo.", "intentExamples": [ "mover para o final", "reordenar campo", "exibir primeiro", "posição 3" ] }, { "path": "width", "category": "layout", "valueKind": "string", "description": "Largura do campo (ex: 50%, 100px).", "intentExamples": [ "campo meia largura", "largura fixa 200px", "ocupar 50%", "width total" ] }, { "path": "isFlex", "category": "layout", "valueKind": "boolean", "description": "Se true, usa flex-grow para preencher espaço.", "intentExamples": [ "preencher espaço sobrando", "campo flexível", "expandir para caber" ] }, { "path": "controlType", "category": "behavior", "valueKind": "enum", "description": "Tipo do componente de UI (input, select, datepicker, etc).", "critical": true, "safetyNotes": "Mudar controlType pode invalidar propriedades específicas do componente anterior. Aplique o overlay de microcomponente correspondente.", "intentExamples": [ "mudar para select", "usar datepicker", "transformar em checkbox", "tipo do controle" ] }, { "path": "dataType", "category": "data", "valueKind": "enum", "description": "Tipo de dado do campo (text, number, date, etc).", "intentExamples": [ "tipo de dado numero", "campo de data" ] }, { "path": "source", "category": "data", "valueKind": "enum", "allowedValues": [ "schema", "local" ], "description": "Origem semântica do campo. Use local para campos do host que não vêm do schema backend.", "intentExamples": [ "campo local", "campo auxiliar do host", "campo que não vem do schema" ], "safetyNotes": "Não marque como local um campo que exista no schema backend; remova a semântica local quando houver colisão com campo server-backed." }, { "path": "transient", "category": "data", "valueKind": "boolean", "description": "Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.", "intentExamples": [ "campo temporário", "campo transient", "não enviar no payload", "usar apenas na UI" ], "safetyNotes": "Campos transient continuam participando de UI, validação, regras, visibilidade e valueChange; eles apenas saem do payload persistido por padrão." }, { "path": "submitPolicy", "category": "behavior", "valueKind": "enum", "allowedValues": [ "include", "omit", "includeWhenDirty" ], "description": "Política de submit para sobrescrever o padrão de campos locais/transient.", "intentExamples": [ "omitir do submit", "enviar mesmo sendo local", "enviar apenas se alterado" ], "safetyNotes": "Use omit para nunca persistir, include para enviar sempre e includeWhenDirty apenas quando o controle estiver dirty." }, { "path": "materialDesign.appearance", "category": "appearance", "valueKind": "enum", "allowedValues": [ "fill", "outline" ], "description": "Aparência do campo Material (fill/outline).", "intentExamples": [ "estilo outline", "aparência preenchida", "campo com borda" ] }, { "path": "materialDesign.color", "category": "appearance", "valueKind": "enum", "allowedValues": [ "primary", "accent", "warn" ], "description": "Tema de cor Material (primary/accent/warn).", "intentExamples": [ "cor primária", "destacar com accent" ] }, { "path": "materialDesign.floatLabel", "category": "appearance", "valueKind": "enum", "allowedValues": [ "auto", "always", "never" ], "description": "Comportamento do rótulo flutuante.", "intentExamples": [ "label sempre flutuando", "nunca flutuar label" ] }, { "path": "materialDesign.subscriptSizing", "category": "appearance", "valueKind": "enum", "allowedValues": [ "fixed", "dynamic" ], "description": "Estratégia de sizing do subscript (erros/hints)." }, { "path": "materialDesign.hideRequiredMarker", "category": "appearance", "valueKind": "boolean", "description": "Oculta o asterisco de campo obrigatório." }, { "path": "materialDesign.density", "category": "appearance", "valueKind": "enum", "allowedValues": [ "comfortable", "compact", "dense" ], "description": "Densidade do campo Material." }, { "path": "materialDesign.disableRipple", "category": "appearance", "valueKind": "boolean", "description": "Desativa ripple/ondulação em componentes Material." }, { "path": "materialDesign.customPalette", "category": "appearance", "valueKind": "object", "description": "Override de paleta (primary/accent/warn).", "safetyNotes": "Use cores válidas; validar contra o tema." }, { "path": "materialDesign.animations", "category": "appearance", "valueKind": "object", "description": "Configuração de animações (disable, duration, easing)." }, { "path": "prefixIcon", "category": "appearance", "valueKind": "string", "description": "Ícone exibido antes do valor.", "intentExamples": [ "ícone de usuário no início", "prefixar ícone", "imagem antes do texto" ] }, { "path": "suffixIcon", "category": "appearance", "valueKind": "string", "description": "Ícone exibido depois do valor.", "intentExamples": [ "ícone de busca no final", "sufixar ícone", "botão de ação no fim" ] }, { "path": "iconPosition", "category": "appearance", "valueKind": "enum", "allowedValues": [ "start", "end" ], "description": "Posição preferencial do ícone principal.", "intentExamples": [ "ícone à esquerda", "posicionar ícone no fim" ] }, { "path": "iconSize", "category": "appearance", "valueKind": "enum", "allowedValues": [ "small", "medium", "large" ], "description": "Tamanho do ícone.", "intentExamples": [ "ícone pequeno", "aumentar tamanho do ícone", "ícone grande" ] }, { "path": "iconColor", "category": "appearance", "valueKind": "string", "description": "Cor semântica ou token de cor aplicado ao ícone principal.", "intentExamples": [ "ícone em cor primária", "usar token do tema no ícone" ] }, { "path": "iconClass", "category": "appearance", "valueKind": "string", "description": "Classe CSS controlada pelo host para o ícone principal.", "intentExamples": [ "usar classe de ícone outlined", "aplicar classe corporativa" ] }, { "path": "iconStyle", "category": "appearance", "valueKind": "string", "description": "Estilo visual semântico do ícone quando o renderer suportar variações.", "intentExamples": [ "usar ícone arredondado", "aplicar estilo filled" ] }, { "path": "iconFontSize", "category": "appearance", "valueKind": "string", "description": "Tamanho tipográfico do ícone principal.", "intentExamples": [ "ícone com 18px", "ajustar tamanho do ícone" ] }, { "path": "valuePresentation", "category": "appearance", "valueKind": "object", "description": "Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.", "safetyNotes": "Preferir este contrato a formatadores legados quando a intencao for apresentacao de valor.", "intentExamples": [ "mostrar como moeda", "formatar como data longa", "exibir percentual" ] }, { "path": "presentation", "category": "appearance", "valueKind": "object", "description": "Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.", "safetyNotes": "Use apenas semantica declarativa; nao incluir CSS arbitrario, HTML, comandos ou efeitos mutaveis.", "intentExamples": [ "status com icone", "badge de pendente", "campo em tom warning" ] }, { "path": "presentation.presenter", "category": "appearance", "valueKind": "enum", "allowedValues": [ "text", "badge", "chip", "status", "iconValue", "progress", "rating", "microVisualization" ], "description": "Tipo semantico de renderizacao em modo apresentacao.", "intentExamples": [ "renderizar como status", "usar chip", "mostrar icone com valor" ] }, { "path": "presentation.tone", "category": "appearance", "valueKind": "enum", "allowedValues": [ "neutral", "info", "success", "warning", "danger" ], "description": "Tom semantico mapeado pelo consumidor para tokens de tema.", "intentExamples": [ "tom de sucesso", "tom de alerta", "tom de erro" ] }, { "path": "presentation.appearance", "category": "appearance", "valueKind": "enum", "allowedValues": [ "plain", "soft", "outlined", "filled" ], "description": "Nivel de enfase visual do apresentador.", "intentExamples": [ "status preenchido", "badge contornado", "chip suave" ] }, { "path": "presentation.icon", "category": "appearance", "valueKind": "string", "description": "Nome de icone Material Symbols usado pelo apresentador semantico.", "intentExamples": [ "icone lock", "icone payments", "icone schedule" ] }, { "path": "presentation.label", "category": "identity", "valueKind": "string", "description": "Rotulo semantico exibido por apresentadores como status, badge ou chip.", "intentExamples": [ "rotulo Bloqueado", "texto Aprovado", "status Aguardando aprovacao" ] }, { "path": "presentation.badge", "category": "appearance", "valueKind": "string", "description": "Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.", "intentExamples": [ "badge alto valor", "marcador D+35", "sinalizar revisao executiva" ] }, { "path": "presentation.valuePresentation", "category": "appearance", "valueKind": "object", "description": "Override de formatacao aplicado apenas pela superficie de apresentacao.", "safetyNotes": "Nao altera o valor real do FormControl nem o payload de submit." }, { "path": "presentation.visualization", "category": "appearance", "valueKind": "object", "description": "Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.", "safetyNotes": "Exige fallback textual e nao pode conter opcoes de ECharts, HTML, SVG bruto, CSS ou comandos.", "intentExamples": [ "micro chart de SLA", "barra empilhada em celula", "bullet chart de orcamento", "fluxo compacto de aprovacao" ] }, { "path": "presentation.visualization.kind", "category": "appearance", "valueKind": "enum", "allowedValues": [ "line", "area", "column", "comparison", "stackedBar", "radial", "harveyBall", "bullet", "delta", "processFlow" ], "description": "Tipo semantico da micro visualizacao de apresentacao.", "intentExamples": [ "comparison", "stackedBar", "bullet", "processFlow" ] }, { "path": "presentation.visualization.surface", "category": "layout", "valueKind": "enum", "allowedValues": [ "table-cell", "list-item", "object-header", "card-summary", "form-presentation" ], "description": "Superficie alvo usada para aplicar regras de densidade e fallback.", "intentExamples": [ "table-cell", "list-item", "form-presentation" ] }, { "path": "presentation.visualization.size", "category": "layout", "valueKind": "enum", "allowedValues": [ "xs", "sm", "md", "lg", "responsive" ], "description": "Tamanho semantico da micro visualizacao.", "intentExamples": [ "xs em tabela", "md em header", "responsive em card" ] }, { "path": "presentation.visualization.fallbackText", "category": "accessibility", "valueKind": "string", "description": "Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.", "safetyNotes": "Deve explicar valor, unidade, meta, tendencia ou estado quando aplicavel." }, { "path": "presentationRules", "category": "appearance", "valueKind": "array", "description": "Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.", "safetyNotes": "As regras devem produzir apenas set/effect semantico. Nao use para alterar valor, executar acao, navegar ou injetar HTML/CSS.", "intentExamples": [ "se status for BLOQUEADO, usar tone danger", "se valor maior que limite, mostrar badge de revisao" ] }, { "path": "presentationRules[].when", "category": "behavior", "valueKind": "object", "description": "Guarda Json Logic avaliada contra o contexto de apresentacao do campo.", "safetyNotes": "Use Json Logic serializavel; funcoes nao sao aceitas." }, { "path": "presentationRules[].set", "category": "appearance", "valueKind": "object", "description": "Patch semantico aplicado sobre presentation quando a guarda for verdadeira.", "safetyNotes": "Somente presenter, tone, icon, label, badge, tooltip, appearance, valuePresentation e interactions seguras." }, { "path": "mask", "category": "appearance", "valueKind": "string", "description": "Máscara de input (padrão do componente).", "intentExamples": [ "máscara de CPF", "formatar telefone", "aplicar máscara de data", "pattern visual" ] }, { "path": "format", "category": "appearance", "valueKind": "string", "description": "Formato de exibição (ex: pipes).", "intentExamples": [ "formato de data dd/mm/yyyy", "formato de moeda", "exibir como porcentagem" ] }, { "path": "validators", "category": "validation", "valueKind": "object", "description": "Objeto contendo todas as regras de validação.", "safetyNotes": "Não sobrescreva este objeto inteiramente; faça merge das propriedades.", "intentExamples": [ "adicionar validações", "regras de validação", "objeto validators" ] }, { "path": "validators.required", "category": "validation", "valueKind": "boolean", "description": "Campo obrigatório.", "intentExamples": [ "tornar obrigatório", "campo mandatório", "exigir preenchimento", "remover required" ] }, { "path": "required", "category": "validation", "valueKind": "boolean", "description": "Campo obrigatório (alias rápido do validators.required).", "intentExamples": [ "campo obrigatório", "exigir preenchimento" ] }, { "path": "validators.requiredMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para required." }, { "path": "validators.email", "category": "validation", "valueKind": "boolean", "description": "Validação de formato de e-mail.", "intentExamples": [ "validar como email", "aceitar apenas emails", "formato de correio eletrônico" ] }, { "path": "validators.emailMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para validação de email." }, { "path": "validators.minLength", "category": "validation", "valueKind": "number", "description": "Comprimento mínimo do texto.", "intentExamples": [ "mínimo de 5 caracteres", "pelo menos 3 letras", "tamanho mínimo" ] }, { "path": "validators.minLengthMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para minLength." }, { "path": "validators.maxLength", "category": "validation", "valueKind": "number", "description": "Comprimento máximo do texto.", "intentExamples": [ "máximo de 100 caracteres", "limitar tamanho", "não exceder 50 letras" ] }, { "path": "validators.maxLengthMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para maxLength." }, { "path": "validators.min", "category": "validation", "valueKind": "number", "description": "Valor numérico mínimo.", "intentExamples": [ "valor mínimo 10", "não aceitar menor que 0", "piso de valor" ] }, { "path": "validators.minMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para min." }, { "path": "validators.max", "category": "validation", "valueKind": "number", "description": "Valor numérico máximo.", "intentExamples": [ "valor máximo 100", "teto de valor", "não aceitar maior que 50" ] }, { "path": "validators.maxMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para max." }, { "path": "validators.pattern", "category": "validation", "valueKind": "string", "description": "Regex para validação.", "safetyNotes": "Cuidado com ReDoS em regex complexos.", "intentExamples": [ "validar com regex", "padrão customizado", "expressão regular" ] }, { "path": "validators.patternMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para pattern." }, { "path": "validators.cpf", "category": "validation", "valueKind": "boolean", "description": "Validador de CPF (legado)." }, { "path": "validators.cnpj", "category": "validation", "valueKind": "boolean", "description": "Validador de CNPJ (legado)." }, { "path": "validators.cpfCnpj", "category": "validation", "valueKind": "boolean", "description": "Validador automatico CPF/CNPJ (legado)." }, { "path": "validators.cnpjAlpha", "category": "validation", "valueKind": "boolean", "description": "Validador de CNPJ alfanumerico (legado)." }, { "path": "validators.cpfMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CPF." }, { "path": "validators.cnpjMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CNPJ." }, { "path": "validators.cnpjAlphaMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para CNPJ alfanumerico." }, { "path": "validators.url", "category": "validation", "valueKind": "boolean", "description": "Validador de URL." }, { "path": "validators.urlMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para URL." }, { "path": "validators.minWords", "category": "validation", "valueKind": "number", "description": "Mínimo de palavras.", "intentExamples": [ "mínimo de 2 palavras", "exigir nome completo (2 palavras)" ] }, { "path": "validators.requiredChecked", "category": "validation", "valueKind": "boolean", "description": "Exige checkbox marcado (ex: termos de uso).", "intentExamples": [ "obrigar marcar checkbox", "aceitar termos é obrigatório" ] }, { "path": "validators.customValidator", "category": "validation", "valueKind": "expression", "description": "Validador customizado (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.asyncValidator", "category": "validation", "valueKind": "expression", "description": "Validador async customizado (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.matchField", "category": "validation", "valueKind": "string", "description": "Campo que deve coincidir (cross-field)." }, { "path": "validators.matchFieldMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para matchField." }, { "path": "validators.uniqueValidator", "category": "validation", "valueKind": "expression", "description": "Validador de unicidade via API (função).", "safetyNotes": "Funções não são serializáveis; exige wiring manual." }, { "path": "validators.uniqueMessage", "category": "validation", "valueKind": "string", "description": "Mensagem customizada para unicidade." }, { "path": "validators.conditionalValidation", "category": "validation", "valueKind": "array", "description": "Regras de validação condicional.", "safetyNotes": "Use regras declarativas com Json Logic serializável; não gere funções aqui." }, { "path": "validators.conditionalValidation[].condition", "category": "validation", "valueKind": "expression", "description": "Condicao para aplicar validadores.", "safetyNotes": "Use Json Logic canônico avaliado sobre o root `form`." }, { "path": "validators.conditionalValidation[].validators", "category": "validation", "valueKind": "object", "description": "Conjunto de validadores aplicados quando a condicao for verdadeira." }, { "path": "validators.validationTrigger", "category": "validation", "valueKind": "enum", "allowedValues": [ "change", "blur", "submit", "immediate" ], "description": "Gatilho de validação no validator." }, { "path": "validators.validationDebounce", "category": "validation", "valueKind": "number", "description": "Debounce de validação no validator (ms)." }, { "path": "validators.showInlineErrors", "category": "validation", "valueKind": "boolean", "description": "Exibe erros inline (validator)." }, { "path": "validators.errorPosition", "category": "validation", "valueKind": "enum", "allowedValues": [ "bottom", "top", "tooltip" ], "description": "Posicao do erro (validator)." }, { "path": "validationMode", "category": "validation", "valueKind": "enum", "allowedValues": [ "immediate", "blur", "submit" ], "description": "Gatilho da validação (change/blur/submit).", "intentExamples": [ "validar ao sair do campo (blur)", "validar apenas no submit", "validação em tempo real" ] }, { "path": "debounceTime", "category": "validation", "valueKind": "number", "description": "Debounce para validação em ms.", "intentExamples": [ "aguardar para validar", "debounce de 500ms", "delay na validação" ] }, { "path": "options", "category": "data", "valueKind": "array", "description": "Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).", "intentExamples": [ "adicionar opções estáticas", "lista fixa de itens", "opções do select" ], "safetyNotes": "Respeite o formato esperado pelo controlType; prefira merge/append em vez de substituir o array inteiro." }, { "path": "endpoint", "category": "data", "valueKind": "string", "description": "URL para carregar opções remotas.", "intentExamples": [ "carregar do servidor", "buscar API", "endpoint de dados", "url das opções" ] }, { "path": "valueField", "category": "data", "valueKind": "string", "description": "Nome da propriedade de valor nas opções.", "intentExamples": [ "usar \"id\" como valor", "campo de valor das opções" ] }, { "path": "displayField", "category": "data", "valueKind": "string", "description": "Nome da propriedade de texto nas opções.", "intentExamples": [ "usar \"nome\" como texto", "exibir campo \"label\"", "campo de exibição" ] }, { "path": "filterField", "category": "data", "valueKind": "string", "description": "Campo para filtragem no backend.", "intentExamples": [ "filtrar por \"categoria\"", "campo de filtro na api" ] }, { "path": "queryParams", "category": "data", "valueKind": "object", "description": "Parâmetros fixos para a query do endpoint.", "intentExamples": [ "parâmetros extras na busca", "enviar tipo=ativo na query" ] }, { "path": "cacheDuration", "category": "data", "valueKind": "number", "description": "Duração do cache de dados em ms.", "intentExamples": [ "cachear por 5 minutos", "tempo de cache", "validade dos dados" ] }, { "path": "hidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta o campo globalmente.", "critical": true, "intentExamples": [ "ocultar campo", "esconder input", "campo invisível" ] }, { "path": "visibleIn", "category": "behavior", "valueKind": "array", "allowedValues": [ "form", "filter", "table", "dialog" ], "description": "Contextos onde o campo é visível.", "intentExamples": [ "mostrar apenas no filtro", "esconder na tabela", "visível só no form" ] }, { "path": "formHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas no formulário.", "intentExamples": [ "esconder no form", "invisível na edição" ] }, { "path": "tableHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas na tabela.", "intentExamples": [ "esconder na listagem", "não mostrar na tabela" ] }, { "path": "filterHidden", "category": "behavior", "valueKind": "boolean", "description": "Oculta apenas no filtro.", "intentExamples": [ "esconder na busca", "remover do filtro" ] }, { "path": "dependencyFields", "category": "dependency", "valueKind": "array", "description": "Campos dos quais este campo depende.", "intentExamples": [ "depende de estado", "campo dependente", "cascata com outro campo" ] }, { "path": "conditionalRequired", "category": "dependency", "valueKind": "expression", "description": "Condição Json Logic para obrigatoriedade declarativa.", "safetyNotes": "Use Json Logic serializável; não gere função nem DSL textual.", "intentExamples": [ "obrigatório se outro campo for X", "condicionalmente requerido" ] }, { "path": "conditionalDisplay", "category": "dependency", "valueKind": "expression", "description": "Condição Json Logic para visibilidade declarativa.", "safetyNotes": "Use Json Logic serializável; não gere função nem DSL textual.", "intentExamples": [ "mostrar se checkbox marcado", "visibilidade condicional" ] }, { "path": "dependencyFilterMap", "category": "dependency", "valueKind": "object", "description": "Mapeamento de filtro baseado na dependência.", "intentExamples": [ "filtrar cidade por estado", "mapear valor da dependência" ] }, { "path": "dependencyValuePath", "category": "dependency", "valueKind": "string", "description": "Caminho no valor da dependência.", "intentExamples": [ "usar propriedade aninhada da dependência", "caminho do valor dependente" ] }, { "path": "dependencyMergeStrategy", "category": "dependency", "valueKind": "enum", "allowedValues": [ "replace", "merge" ], "description": "Estratégia de merge dos dados carregados.", "intentExamples": [ "substituir opções ao carregar", "mesclar resultados" ] }, { "path": "dependencyLoadOnChange", "category": "dependency", "valueKind": "enum", "allowedValues": [ "respectLoadOn", "immediate", "manual" ], "description": "Quando recarregar dependência.", "intentExamples": [ "recarregar assim que mudar", "recarregar manualmente", "carregar imediatamente" ] }, { "path": "resetOnDependentChange", "category": "dependency", "valueKind": "boolean", "description": "Zera valor se dependência mudar.", "intentExamples": [ "limpar se o pai mudar", "resetar valor na troca da dependência" ] }, { "path": "enableDependencyCascade", "category": "dependency", "valueKind": "boolean", "description": "Habilita/desabilita cascata nativa de dependências entre campos.", "intentExamples": [ "desativar cascata nativa", "habilitar cascata", "usar connections sem cascata" ] }, { "path": "dependencyDebounceMs", "category": "dependency", "valueKind": "number", "description": "Delay para reagir à mudança de dependência.", "intentExamples": [ "esperar para recarregar dependência", "debounce da cascata" ] }, { "path": "suppressInlineErrorsOnCascade", "category": "dependency", "valueKind": "boolean", "description": "Suprime erros inline durante cascata." }, { "path": "transformDisplayValue", "category": "transform", "valueKind": "expression", "description": "Transforma valor para exibição.", "safetyNotes": "Função não serializável.", "intentExamples": [ "formatar valor visualmente", "transformar display" ] }, { "path": "transformSaveValue", "category": "transform", "valueKind": "expression", "description": "Transforma valor para salvar.", "safetyNotes": "Função não serializável.", "intentExamples": [ "formatar valor para envio", "transformar payload" ] }, { "path": "textTransformApply", "category": "transform", "valueKind": "enum", "allowedValues": [ "displayOnly", "saveOnly", "both" ], "description": "Quando aplicar transformação de texto.", "intentExamples": [ "aplicar transformação apenas no display", "transformar ao salvar e exibir" ] }, { "path": "inlineEditing", "category": "behavior", "valueKind": "boolean", "description": "Permite edição inline (tabelas).", "intentExamples": [ "permitir edição na tabela", "editar na linha" ] }, { "path": "unique", "category": "validation", "valueKind": "boolean", "description": "Valida unicidade no backend.", "intentExamples": [ "validar se é único", "não permitir duplicados" ] }, { "path": "readOnly", "category": "behavior", "valueKind": "boolean", "description": "Campo somente leitura.", "intentExamples": [ "somente leitura", "bloquear edição", "campo readonly" ] }, { "path": "disabled", "category": "behavior", "valueKind": "boolean", "description": "Campo desabilitado.", "intentExamples": [ "desabilitar campo", "campo disabled", "cinza e bloqueado" ] }, { "path": "defaultValue", "category": "data", "valueKind": "object", "description": "Valor inicial do campo.", "safetyNotes": "Aceita tipos primitivos/objetos; respeite o controlType.", "intentExamples": [ "valor padrão", "iniciar com valor X", "default value" ] }, { "path": "ariaLabel", "category": "accessibility", "valueKind": "string", "description": "Label para leitores de tela.", "intentExamples": [ "label de acessibilidade", "texto para leitor de tela" ] }, { "path": "ariaDescribedBy", "category": "accessibility", "valueKind": "string", "description": "IDs de descrição acessível.", "intentExamples": [ "descrito pelo elemento X", "associar descrição aria" ] }, { "path": "tabIndex", "category": "accessibility", "valueKind": "number", "description": "Ordem de tabulacao para teclado.", "intentExamples": [ "tabindex 0", "ordem de foco" ] }, { "path": "accessKey", "category": "accessibility", "valueKind": "string", "description": "Atalho de teclado (accessKey).", "intentExamples": [ "atalho de teclado", "tecla de acesso rapido" ] } ], "authoringManifest": { "schemaVersion": "1.0.0", "componentId": "praxis-dynamic-fields", "ownerPackage": "@praxisui/dynamic-fields", "configSchemaId": "FieldMetadata", "manifestVersion": "1.0.0", "runtimeInputs": [ { "name": "fieldMetadata", "type": "FieldMetadata", "description": "Canonical field metadata consumed by dynamic field loaders." }, { "name": "controlType", "type": "FieldControlType", "description": "Control type resolved through ComponentRegistryService." }, { "name": "componentRegistry", "type": "ComponentRegistryService", "description": "Runtime registry for package-owned and host custom fields." }, { "name": "componentMetadataRegistry", "type": "ComponentMetadataRegistry", "description": "Editorial discovery registry for field tooling." } ], "editableTargets": [ { "kind": "controlType", "resolver": "field-control-type-token", "description": "A canonical FieldControlType token." }, { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "description": "Alias resolved through core control-type normalization." }, { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "description": "Package-owned editorial descriptor in src/lib/editorial/**." }, { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "description": "Selector-to-controlType mapping used by config-first flows." }, { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "FieldMetadata capability path governed by @praxisui/core." }, { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "description": "Runtime ComponentRegistryService coverage for a control type." }, { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "description": "Metadata-editor and downstream tooling coverage for a control type." } ], "operations": [ { "operationId": "controlType.register", "title": "Register control type runtime support", "scope": "controlType", "targetKind": "controlType", "target": { "kind": "controlType", "resolver": "field-control-type-token", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean", "default": true } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-control-registration", "handlerContract": { "reads": [ "componentRegistry", "componentMetadata[]", "fieldMetadata.controlType" ], "writes": [ "componentRegistry", "componentMetadata[]" ], "identityKeys": [ "controlType", "selector" ], "inputSchema": { "type": "object", "required": [ "controlType", "selector", "componentExport" ], "properties": { "controlType": { "type": "string" }, "selector": { "type": "string" }, "componentExport": { "type": "string" }, "lazyImportPath": { "type": "string" }, "packageOwned": { "type": "boolean" } } }, "failureModes": [ "control-type-already-registered", "selector-already-registered", "runtime-component-unresolvable" ], "description": "Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities." } } ], "validators": [ "control-type-unique", "runtime-component-resolves", "field-metadata-compatible" ], "affectedPaths": [ "componentRegistry", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.add", "title": "Add control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": false }, "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-registration", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias", "controlType" ], "inputSchema": { "type": "object", "required": [ "alias", "controlType" ], "properties": { "alias": { "type": "string" }, "controlType": { "type": "string" }, "reason": { "type": "string" } } }, "failureModes": [ "alias-already-registered", "target-control-type-unresolvable", "alias-normalizes-to-multiple-targets" ], "description": "Adds a deterministic control alias that normalizes to one registered canonical controlType." } } ], "validators": [ "alias-resolves-deterministically", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "controlTypeAliases", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized" ] }, { "operationId": "controlType.alias.remove", "title": "Remove control type alias", "scope": "controlAlias", "targetKind": "controlAlias", "target": { "kind": "controlAlias", "resolver": "normalized-control-type-alias", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-alias-removal", "handlerContract": { "reads": [ "controlTypeAliases", "componentRegistry" ], "writes": [ "controlTypeAliases" ], "identityKeys": [ "alias" ], "inputSchema": { "type": "object", "required": [ "alias" ], "properties": { "alias": { "type": "string" }, "replacementControlType": { "type": "string" } } }, "failureModes": [ "alias-not-found", "replacement-control-type-unresolvable", "alias-still-referenced-without-replacement" ], "description": "Removes one alias by normalized alias identity after validating replacement coverage for downstream configs." } } ], "destructive": true, "requiresConfirmation": true, "validators": [ "alias-exists", "alias-removal-safe", "destructive-removal-confirmation" ], "affectedPaths": [ "controlTypeAliases" ], "submissionImpact": "config-only", "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "descriptor.update", "title": "Update editorial descriptor", "scope": "editorialDescriptor", "targetKind": "editorialDescriptor", "target": { "kind": "editorialDescriptor", "resolver": "component-metadata-editorial-descriptor", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "friendlyName": { "type": "string" }, "description": { "type": "string" }, "icon": { "type": "string" }, "category": { "type": "string" }, "recommendedWhen": { "type": "array", "items": { "type": "string" } }, "avoidWhen": { "type": "array", "items": { "type": "string" } }, "i18nNamespace": { "type": "string" } } }, "effects": [ { "kind": "merge-by-key", "path": "editorialDescriptors[]", "key": "controlType" } ], "validators": [ "descriptor-exists", "editorial-source-canonical", "editor-tooling-discovers-control" ], "affectedPaths": [ "editorialDescriptors[]", "componentMetadata[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "selector.mapping.set", "title": "Set selector mapping", "scope": "selectorMapping", "targetKind": "selectorMapping", "target": { "kind": "selectorMapping", "resolver": "field-selector-registry-entry", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-selector-mapping-set", "handlerContract": { "reads": [ "FieldSelectorRegistry", "DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP", "componentRegistry" ], "writes": [ "FieldSelectorRegistry" ], "identityKeys": [ "selector", "controlType" ], "inputSchema": { "type": "object", "required": [ "selector", "controlType" ], "properties": { "selector": { "type": "string" }, "controlType": { "type": "string" }, "overwrite": { "type": "boolean" }, "source": { "enum": [ "package-default", "host-extension" ] } } }, "failureModes": [ "selector-already-mapped", "control-type-unresolvable", "selector-mapping-would-shadow-package-default" ], "description": "Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions." } } ], "validators": [ "selector-mapping-deterministic", "runtime-component-resolves", "editor-tooling-discovers-control" ], "affectedPaths": [ "selectorMappings[]", "fieldMetadata.controlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "metadata.mapping.set", "title": "Set metadata path mapping", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "path", "valueKind" ], "properties": { "path": { "type": "string" }, "valueKind": { "enum": [ "string", "number", "boolean", "enum", "object", "array", "expression" ] }, "controlTypes": { "type": "array", "items": { "type": "string" } }, "required": { "type": "boolean" }, "allowedValues": { "type": "array" } } }, "effects": [ { "kind": "merge-by-key", "path": "fieldMetadataCapabilities[]", "key": "path" } ], "validators": [ "field-metadata-compatible", "metadata-capability-aligned", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadataCapabilities[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "editorCoverage.validate", "title": "Validate editor coverage", "scope": "editorCoverage", "targetKind": "editorCoverage", "target": { "kind": "editorCoverage", "resolver": "metadata-editor-tooling-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-editor-coverage-validation", "handlerContract": { "reads": [ "componentMetadata[]", "editorialDescriptors[]", "fieldMetadataCapabilities[]" ], "writes": [ "editorCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "metadataEditor": { "type": "boolean" }, "dynamicFormDiscovery": { "type": "boolean" }, "filterTooling": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "editor-coverage-missing", "dynamic-form-discovery-missing", "coverage-evidence-missing" ], "description": "Validates editor/tooling discovery for one controlType separately from runtime rendering support." } } ], "validators": [ "editor-tooling-discovers-control", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "editorCoverage", "componentMetadata[]", "editorialDescriptors[]" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] }, { "operationId": "runtimeCoverage.validate", "title": "Validate runtime coverage", "scope": "runtimeCoverage", "targetKind": "runtimeCoverage", "target": { "kind": "runtimeCoverage", "resolver": "component-registry-coverage", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "effects": [ { "kind": "compile-domain-patch", "handler": "dynamic-fields-runtime-coverage-validation", "handlerContract": { "reads": [ "componentRegistry", "fieldMetadata.controlType" ], "writes": [ "runtimeCoverage" ], "identityKeys": [ "controlType" ], "inputSchema": { "type": "object", "required": [ "controlType" ], "properties": { "controlType": { "type": "string" }, "componentRegistered": { "type": "boolean" }, "valueAccessor": { "type": "boolean" }, "hotMetadata": { "type": "boolean" }, "evidence": { "type": "array", "items": { "type": "string" } } } }, "failureModes": [ "runtime-component-unresolvable", "value-accessor-missing", "runtime-evidence-missing" ], "description": "Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage." } } ], "validators": [ "runtime-component-resolves", "runtime-editor-coverage-not-divergent", "coverage-evidence-present" ], "affectedPaths": [ "runtimeCoverage", "componentRegistry" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "registry-initialized", "target-exists" ] } ], "validators": [ { "validatorId": "control-type-unique", "level": "error", "code": "PDF001", "description": "Package-owned control types must be unique and stable." }, { "validatorId": "runtime-component-resolves", "level": "error", "code": "PDF002", "description": "ComponentRegistryService must resolve the runtime component for the target controlType." }, { "validatorId": "field-metadata-compatible", "level": "error", "code": "PDF003", "description": "Control metadata must align with FieldMetadata semantics from @praxisui/core." }, { "validatorId": "alias-resolves-deterministically", "level": "error", "code": "PDF004", "description": "Aliases must normalize to a single canonical controlType." }, { "validatorId": "alias-exists", "level": "error", "code": "PDF005", "description": "Alias removal requires an existing alias target." }, { "validatorId": "alias-removal-safe", "level": "error", "code": "PDF006", "description": "Alias removal must provide migration or replacement when downstream configs may still use it." }, { "validatorId": "destructive-removal-confirmation", "level": "error", "code": "PDF007", "description": "Destructive alias removal requires explicit confirmation." }, { "validatorId": "descriptor-exists", "level": "error", "code": "PDF008", "description": "Editorial descriptor updates require an existing package-owned descriptor." }, { "validatorId": "editorial-source-canonical", "level": "error", "code": "PDF009", "description": "Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides." }, { "validatorId": "editor-tooling-discovers-control", "level": "error", "code": "PDF010", "description": "Dynamic-form, metadata-editor and downstream tooling must discover the control metadata." }, { "validatorId": "metadata-capability-aligned", "level": "error", "code": "PDF011", "description": "Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities." }, { "validatorId": "runtime-editor-coverage-not-divergent", "level": "error", "code": "PDF012", "description": "Runtime support and editor/tooling coverage must not diverge silently." }, { "validatorId": "coverage-evidence-present", "level": "error", "code": "PDF013", "description": "Coverage validation operations must include concrete evidence paths or spec names." }, { "validatorId": "selector-mapping-deterministic", "level": "error", "code": "PDF014", "description": "Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly." } ], "roundTripRequirements": [ "Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.", "Aliases must resolve through the canonical core normalization path and must not become host-only conventions.", "Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support." ], "examples": [ { "id": "register-package-owned-control-type", "request": "Register a package-owned field control and make it runtime-resolvable.", "operationId": "controlType.register", "params": { "controlType": "myControl", "selector": "pdx-my-control", "componentExport": "PdxMyControlComponent", "packageOwned": true }, "isPositive": true }, { "id": "add-control-alias", "request": "Allow legacy alias my-control to resolve to myControl.", "operationId": "controlType.alias.add", "params": { "alias": "my-control", "controlType": "myControl", "reason": "legacy schema compatibility" }, "isPositive": true }, { "id": "remove-control-alias-with-confirmation", "request": "Remove obsolete alias old-control after migration.", "operationId": "controlType.alias.remove", "target": "old-control", "params": { "alias": "old-control", "replacementControlType": "myControl" }, "isPositive": true }, { "id": "update-editorial-descriptor", "request": "Update friendly name and icon for a package-owned control.", "operationId": "descriptor.update", "target": "myControl", "params": { "friendlyName": "My Control", "icon": "widgets", "i18nNamespace": "dynamicFields" }, "isPositive": true }, { "id": "set-selector-mapping", "request": "Map pdx-my-control to myControl in the selector registry.", "operationId": "selector.mapping.set", "target": "pdx-my-control", "params": { "selector": "pdx-my-control", "controlType": "myControl", "source": "package-default" }, "isPositive": true }, { "id": "set-field-metadata-mapping", "request": "Publish a metadata capability path for option source mapping.", "operationId": "metadata.mapping.set", "target": "optionSource.dependsOn", "params": { "path": "optionSource.dependsOn", "valueKind": "array", "controlTypes": [ "select", "entityLookup" ] }, "isPositive": true }, { "id": "validate-editor-coverage", "request": "Prove that metadata editor and dynamic form can discover the control.", "operationId": "editorCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "metadataEditor": true, "dynamicFormDiscovery": true, "filterTooling": false, "evidence": [ "component-metadata-registry.spec.ts" ] }, "isPositive": true }, { "id": "validate-runtime-coverage", "request": "Prove runtime registry and value accessor coverage.", "operationId": "runtimeCoverage.validate", "target": "myControl", "params": { "controlType": "myControl", "componentRegistered": true, "valueAccessor": true, "hotMetadata": true, "evidence": [ "component-registry.service.spec.ts" ] }, "isPositive": true }, { "id": "reject-runtime-only-control", "request": "Mark a control supported because it renders, without editor metadata evidence.", "operationId": "editorCoverage.validate", "target": "runtimeOnlyControl", "params": { "controlType": "runtimeOnlyControl", "metadataEditor": false, "dynamicFormDiscovery": false, "evidence": [] }, "isPositive": false } ], "controlProfiles": [ { "profileId": "text-input", "title": "Text input controls", "description": "Profile for text-like controls, including inline and Material text inputs.", "appliesTo": { "componentIds": [ "pdx-email-input", "pdx-inline-input", "pdx-inline-phone", "pdx-material-textarea", "pdx-password-input", "pdx-phone-input", "pdx-search-input", "pdx-text-input", "pdx-url-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Text metadata paths such as placeholder, length limits, pattern, mask and autocomplete." } ], "operations": [ { "operationId": "field.text.configure", "title": "Configure text field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "placeholder": { "type": "string" }, "minLength": { "type": "number" }, "maxLength": { "type": "number" }, "pattern": { "type": "string" }, "mask": { "type": "string" }, "autocomplete": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "text-metadata-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.placeholder", "fieldMetadata.minLength", "fieldMetadata.maxLength", "fieldMetadata.pattern", "fieldMetadata.mask", "fieldMetadata.autocomplete" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "text-metadata-compatible", "level": "error", "code": "PDFP001", "description": "Text constraints must preserve string field semantics and editor/runtime round-trip." } ], "examples": [ { "id": "configure-text-placeholder-and-length", "request": "Set placeholder and maximum length for a text input.", "operationId": "field.text.configure", "params": { "placeholder": "Search by name", "maxLength": 120 }, "isPositive": true } ], "roundTripRequirements": [ "Text constraints must round-trip through FieldMetadata and downstream tooling without becoming host-only placeholder state." ] }, { "profileId": "numeric", "title": "Numeric controls", "description": "Profile for number, slider, range, rating, distance and score controls.", "appliesTo": { "componentIds": [ "pdx-inline-distance-radius", "pdx-inline-number", "pdx-inline-range-slider", "pdx-inline-rating", "pdx-inline-score-priority", "pdx-material-range-slider", "pdx-material-rating", "pdx-material-slider", "pdx-number-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Numeric metadata paths such as min, max, step, precision and display format." } ], "operations": [ { "operationId": "field.numeric.configure", "title": "Configure numeric field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "number" }, "max": { "type": "number" }, "step": { "type": "number" }, "precision": { "type": "number" }, "displayFormat": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "numeric-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.step", "fieldMetadata.precision", "fieldMetadata.displayFormat" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "numeric-range-valid", "level": "error", "code": "PDFP002", "description": "Numeric min, max, step and precision must be mutually valid for the target control." } ], "examples": [ { "id": "configure-rating-scale", "request": "Set rating control to five points with half-step increments.", "operationId": "field.numeric.configure", "params": { "min": 0, "max": 5, "step": 0.5 }, "isPositive": true } ] }, { "profileId": "currency", "title": "Currency controls", "description": "Profile for currency and price-range controls.", "appliesTo": { "componentIds": [ "pdx-inline-currency", "pdx-inline-currency-range", "pdx-material-currency", "pdx-material-price-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Currency metadata paths such as currency code, locale, precision and range mode." } ], "operations": [ { "operationId": "field.currency.configure", "title": "Configure currency field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "currencyCode": { "type": "string" }, "locale": { "type": "string" }, "min": { "type": "number" }, "max": { "type": "number" }, "precision": { "type": "number" }, "rangeMode": { "enum": [ "single", "range" ] } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "currency-code-valid", "currency-range-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.currencyCode", "fieldMetadata.locale", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.precision", "fieldMetadata.rangeMode" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "currency-code-valid", "level": "error", "code": "PDFP003", "description": "Currency controls require a valid ISO currency code and locale-aware formatting semantics." }, { "validatorId": "currency-range-valid", "level": "error", "code": "PDFP004", "description": "Currency range bounds must be ordered and compatible with precision." } ], "examples": [ { "id": "configure-brl-currency", "request": "Configure the currency field for Brazilian Real with two decimals.", "operationId": "field.currency.configure", "params": { "currencyCode": "BRL", "locale": "pt-BR", "precision": 2 }, "isPositive": true } ] }, { "profileId": "select", "title": "Select controls", "description": "Profile for select, autocomplete, async select, chips, status, sentiment and button-toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-async-select", "pdx-inline-autocomplete", "pdx-inline-color-label", "pdx-inline-multi-select", "pdx-inline-pipeline-status", "pdx-inline-searchable-select", "pdx-inline-select", "pdx-inline-sentiment", "pdx-material-async-select", "pdx-material-autocomplete", "pdx-material-button-toggle", "pdx-material-checkbox-group", "pdx-material-chips", "pdx-material-multi-select", "pdx-material-radio-group", "pdx-material-searchable-select", "pdx-material-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Option source, local options, display/value fields, search and multi-select metadata paths." } ], "operations": [ { "operationId": "field.select.configure", "title": "Configure select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "options": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "searchable": { "type": "boolean" }, "async": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.options", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.searchable", "fieldMetadata.async" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-select-options", "request": "Configure select to store ids and display labels.", "operationId": "field.select.configure", "params": { "valueField": "id", "displayField": "label", "searchable": true }, "isPositive": true } ] }, { "profileId": "entity-lookup", "title": "Entity lookup controls", "description": "Profile for entity lookup controls that bind to remote resources.", "appliesTo": { "componentIds": [ "pdx-entity-lookup", "pdx-inline-entity-lookup" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Entity lookup metadata paths such as resourcePath, value/display fields and search behavior." } ], "operations": [ { "operationId": "field.entityLookup.configure", "title": "Configure entity lookup field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "resourcePath": { "type": "string" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "searchable": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "entity-resource-binding-valid", "option-source-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.resourcePath", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.searchable" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "entity-resource-binding-valid", "level": "error", "code": "PDFP007", "description": "Entity lookup controls require canonical resource binding and stable value/display identity fields." }, { "validatorId": "option-source-valid", "level": "error", "code": "PDFP005", "description": "Option controls require canonical optionSource/options semantics, including cascade dependency mappings when present." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-entity-lookup", "request": "Bind the entity lookup to users and show the name while storing the id.", "operationId": "field.entityLookup.configure", "params": { "optionSource": { "key": "user", "type": "RESOURCE_ENTITY", "resourcePath": "/users", "valuePropertyPath": "id", "labelPropertyPath": "name", "includeIds": false, "capabilities": { "filter": true, "byIds": true }, "dependsOn": [ "companyId" ], "dependencyFilterMap": { "companyId": "companyId" } }, "valueField": "id", "displayField": "name", "searchable": true }, "isPositive": true } ] }, { "profileId": "tree-select", "title": "Tree select controls", "description": "Profile for hierarchical tree select controls.", "appliesTo": { "componentIds": [ "pdx-inline-tree-select", "pdx-material-multi-select-tree", "pdx-material-tree-select" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Tree option metadata paths such as node id, parent id, children path, lazy loading and multi-selection." } ], "operations": [ { "operationId": "field.treeSelect.configure", "title": "Configure tree select field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "optionSource": { "type": "object" }, "nodeIdField": { "type": "string" }, "parentIdField": { "type": "string" }, "childrenField": { "type": "string" }, "multiple": { "type": "boolean" }, "lazyLoad": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "tree-node-identity-valid", "tree-option-source-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.optionSource", "fieldMetadata.nodeIdField", "fieldMetadata.parentIdField", "fieldMetadata.childrenField", "fieldMetadata.multiple", "fieldMetadata.lazyLoad" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "tree-node-identity-valid", "level": "error", "code": "PDFP008", "description": "Tree controls require stable node identity and valid parent/children references." }, { "validatorId": "tree-option-source-valid", "level": "error", "code": "PDFP009", "description": "Tree option sources must expose hierarchical data compatible with the configured node fields." } ], "examples": [ { "id": "configure-tree-select", "request": "Configure tree select with id, parentId and children fields.", "operationId": "field.treeSelect.configure", "params": { "nodeIdField": "id", "parentIdField": "parentId", "childrenField": "children" }, "isPositive": true } ] }, { "profileId": "list-transfer", "title": "List and transfer controls", "description": "Profile for selection-list and transfer-list controls.", "appliesTo": { "componentIds": [ "pdx-material-selection-list", "pdx-material-transfer-list" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "List option metadata paths such as options, selection mode, value field and ordering." } ], "operations": [ { "operationId": "field.list.configure", "title": "Configure list field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "options": { "type": "array" }, "transferOptions": { "type": "array" }, "valueField": { "type": "string" }, "displayField": { "type": "string" }, "multiple": { "type": "boolean" }, "ordered": { "type": "boolean" }, "maxSelections": { "type": "number" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "list-selection-valid", "option-identity-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.options", "fieldMetadata.transferOptions", "fieldMetadata.valueField", "fieldMetadata.displayField", "fieldMetadata.multiple", "fieldMetadata.ordered", "fieldMetadata.maxSelections" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "list-selection-valid", "level": "error", "code": "PDFP010", "description": "List selection metadata must preserve stable option identity and selected value shape." }, { "validatorId": "option-identity-valid", "level": "error", "code": "PDFP006", "description": "Value and display identity fields must exist in local options or the remote option source schema." } ], "examples": [ { "id": "configure-transfer-list", "request": "Configure transfer list to store ids and display labels with a maximum of three selected items.", "operationId": "field.list.configure", "params": { "valueField": "id", "displayField": "label", "multiple": true, "ordered": true, "maxSelections": 3 }, "isPositive": true } ] }, { "profileId": "date", "title": "Date controls", "description": "Profile for single date, datetime, month, week, year and time picker controls.", "appliesTo": { "componentIds": [ "pdx-date-input", "pdx-datetime-local-input", "pdx-inline-date", "pdx-inline-time", "pdx-material-datepicker", "pdx-material-timepicker", "pdx-month-input", "pdx-time-input", "pdx-week-input", "pdx-year-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date/time metadata paths such as min, max, timezone, locale and format." } ], "operations": [ { "operationId": "field.date.configure", "title": "Configure date or time field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "min": { "type": "string" }, "max": { "type": "string" }, "timezone": { "type": "string" }, "locale": { "type": "string" }, "format": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "temporal-bounds-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.timezone", "fieldMetadata.locale", "fieldMetadata.format" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-date-min-max", "request": "Limit the date field to the current year in Sao Paulo timezone.", "operationId": "field.date.configure", "params": { "min": "2026-01-01", "max": "2026-12-31", "timezone": "America/Sao_Paulo" }, "isPositive": true } ] }, { "profileId": "date-range", "title": "Date range controls", "description": "Profile for date range, month range, year range, period and relative-period controls.", "appliesTo": { "componentIds": [ "pdx-inline-date-range", "pdx-inline-month-range", "pdx-inline-period-range", "pdx-inline-relative-period", "pdx-inline-year-range", "pdx-material-date-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Date range metadata paths such as start/end field mapping, min/max and presets." } ], "operations": [ { "operationId": "field.dateRange.configure", "title": "Configure date range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "min": { "type": "string" }, "max": { "type": "string" }, "presets": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "date-range-fields-valid", "temporal-bounds-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.min", "fieldMetadata.max", "fieldMetadata.presets" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "date-range-fields-valid", "level": "error", "code": "PDFP013", "description": "Date range controls require distinct start/end field semantics and ordered submitted values." }, { "validatorId": "temporal-bounds-valid", "level": "error", "code": "PDFP011", "description": "Temporal min and max values must be valid and ordered for the target control granularity." } ], "examples": [ { "id": "configure-date-range-fields", "request": "Use createdFrom and createdTo as the date range field names.", "operationId": "field.dateRange.configure", "params": { "startField": "createdFrom", "endField": "createdTo" }, "isPositive": true } ] }, { "profileId": "time-range", "title": "Time range controls", "description": "Profile for time range controls.", "appliesTo": { "componentIds": [ "pdx-inline-time-range", "pdx-material-time-range" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Time range metadata paths such as start/end fields, step minutes and timezone." } ], "operations": [ { "operationId": "field.timeRange.configure", "title": "Configure time range field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "startField": { "type": "string" }, "endField": { "type": "string" }, "stepMinutes": { "type": "number" }, "timezone": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "time-range-fields-valid", "timezone-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.startField", "fieldMetadata.endField", "fieldMetadata.stepMinutes", "fieldMetadata.timezone" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "time-range-fields-valid", "level": "error", "code": "PDFP014", "description": "Time range controls require distinct start/end field semantics and valid interval steps." }, { "validatorId": "timezone-valid", "level": "error", "code": "PDFP012", "description": "Timezone configuration must use a valid named timezone when the control is timezone-sensitive." } ], "examples": [ { "id": "configure-time-range-step", "request": "Configure a time range with fifteen minute increments.", "operationId": "field.timeRange.configure", "params": { "stepMinutes": 15 }, "isPositive": true } ] }, { "profileId": "toggle", "title": "Toggle controls", "description": "Profile for boolean toggle controls.", "appliesTo": { "componentIds": [ "pdx-inline-toggle", "pdx-material-slide-toggle" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Boolean metadata paths such as true label, false label and default value." } ], "operations": [ { "operationId": "field.toggle.configure", "title": "Configure toggle field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "trueLabel": { "type": "string" }, "falseLabel": { "type": "string" }, "defaultValue": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "boolean-toggle-compatible", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.trueLabel", "fieldMetadata.falseLabel", "fieldMetadata.defaultValue" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "boolean-toggle-compatible", "level": "error", "code": "PDFP015", "description": "Toggle controls must preserve boolean value semantics and not serialize labels as submitted values." } ], "examples": [ { "id": "configure-toggle-labels", "request": "Set yes/no labels for a toggle without changing boolean submission.", "operationId": "field.toggle.configure", "params": { "trueLabel": "Yes", "falseLabel": "No" }, "isPositive": true } ] }, { "profileId": "color", "title": "Color controls", "description": "Profile for color input and picker controls.", "appliesTo": { "componentIds": [ "pdx-color-input", "pdx-color-picker", "pdx-material-colorpicker" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Color metadata paths such as format, alpha support and palette presets." } ], "operations": [ { "operationId": "field.color.configure", "title": "Configure color field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "format": { "enum": [ "hex", "rgb", "rgba" ] }, "allowAlpha": { "type": "boolean" }, "palette": { "type": "array" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "color-format-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.format", "fieldMetadata.allowAlpha", "fieldMetadata.palette" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "color-format-valid", "level": "error", "code": "PDFP016", "description": "Color values and palette entries must match the configured color format." } ], "examples": [ { "id": "configure-color-hex-palette", "request": "Use hex colors and offer brand palette presets.", "operationId": "field.color.configure", "params": { "format": "hex", "allowAlpha": false, "palette": [ "#0057B8", "#00A676" ] }, "isPositive": true } ] }, { "profileId": "regional-document", "title": "Regional document controls", "description": "Profile for Brazilian CPF/CNPJ document input controls.", "appliesTo": { "componentIds": [ "pdx-material-cpf-cnpj-input" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Regional document metadata paths such as document type, mask and validation mode." } ], "operations": [ { "operationId": "field.regionalDocument.configure", "title": "Configure regional document field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "documentType": { "enum": [ "cpf", "cnpj", "cpfOrCnpj" ] }, "mask": { "type": "string" }, "validateChecksum": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "regional-document-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.documentType", "fieldMetadata.mask", "fieldMetadata.validateChecksum" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "regional-document-valid", "level": "error", "code": "PDFP017", "description": "Regional document controls must preserve document type, mask and checksum validation semantics." } ], "examples": [ { "id": "configure-cpf-cnpj-document", "request": "Accept CPF or CNPJ and validate the document checksum.", "operationId": "field.regionalDocument.configure", "params": { "documentType": "cpfOrCnpj", "validateChecksum": true }, "isPositive": true } ] }, { "profileId": "file-upload", "title": "File upload controls", "description": "Profile for file upload controls that bind field metadata to accepted file types, limits and storage semantics.", "appliesTo": { "componentIds": [ "pdx-material-file-upload" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "File upload metadata paths such as accepted types, maximum file size, multiplicity and upload endpoint binding." } ], "operations": [ { "operationId": "field.fileUpload.configure", "title": "Configure file upload field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "accept": { "type": "array" }, "maxFileSize": { "type": "number" }, "multiple": { "type": "boolean" }, "maxFiles": { "type": "number" }, "uploadEndpoint": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "file-upload-policy-valid", "file-upload-endpoint-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.accept", "fieldMetadata.maxFileSize", "fieldMetadata.multiple", "fieldMetadata.maxFiles", "fieldMetadata.uploadEndpoint" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "file-upload-policy-valid", "level": "error", "code": "PDFP020", "description": "File upload controls require explicit file type, size and multiplicity constraints before storage binding." }, { "validatorId": "file-upload-endpoint-valid", "level": "error", "code": "PDFP021", "description": "Upload endpoint metadata must map to the canonical host/backend upload contract instead of an ad hoc URL." } ], "examples": [ { "id": "configure-pdf-upload", "request": "Allow up to three PDF files with a five megabyte limit.", "operationId": "field.fileUpload.configure", "params": { "accept": [ "application/pdf" ], "maxFileSize": 5242880, "multiple": true, "maxFiles": 3 }, "isPositive": true } ] }, { "profileId": "collection", "title": "Collection controls", "description": "Profile for repeatable collection controls that manage array-shaped field values.", "appliesTo": { "componentIds": [ "pdx-editable-collection" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Collection metadata paths such as item schema, minimum and maximum items, ordering and add/remove behavior." } ], "operations": [ { "operationId": "field.collection.configure", "title": "Configure collection field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "itemSchema": { "type": "object" }, "minItems": { "type": "number" }, "maxItems": { "type": "number" }, "ordered": { "type": "boolean" }, "allowAdd": { "type": "boolean" }, "allowRemove": { "type": "boolean" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "collection-item-schema-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.itemSchema", "fieldMetadata.minItems", "fieldMetadata.maxItems", "fieldMetadata.ordered", "fieldMetadata.allowAdd", "fieldMetadata.allowRemove" ], "submissionImpact": "affects-schema-backed-data", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "collection-item-schema-valid", "level": "error", "code": "PDFP022", "description": "Collection controls require array-compatible item schema and stable item identity semantics." } ], "examples": [ { "id": "configure-repeatable-addresses", "request": "Configure a repeatable address collection with at least one item.", "operationId": "field.collection.configure", "params": { "minItems": 1, "ordered": true, "allowAdd": true, "allowRemove": true }, "isPositive": true } ] }, { "profileId": "avatar", "title": "Avatar controls", "description": "Profile for avatar controls that render image, initials, fallback identity metadata or governed avatar groups.", "appliesTo": { "componentIds": [ "pdx-material-avatar" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Avatar metadata paths such as image source, initials, fallback icon, size, tone, status, badge, group stack and accessible text." } ], "operations": [ { "operationId": "field.avatar.configure", "title": "Configure avatar field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "extra": { "type": "object", "minProperties": 1, "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "size": { "enum": [ "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "border": { "type": "boolean" }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "badge": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "badgeLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "initialsMaxLength": { "type": "number", "minimum": 1, "maximum": 4 }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" }, "groupLabel": { "type": "string" }, "groupMaxVisible": { "type": "number", "minimum": 1, "maximum": 12 }, "groupOverflowLabel": { "type": "string" }, "groupOverlap": { "type": "number", "minimum": 0, "maximum": 32 }, "groupItems": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "imageSrc": { "type": "string" }, "imageAlt": { "type": "string" }, "initials": { "type": "string" }, "name": { "type": "string" }, "icon": { "type": "string" }, "defaultIcon": { "type": "string" }, "themeColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "rounded": { "enum": [ "full", "large", "medium", "small", "none" ] }, "fillMode": { "enum": [ "solid", "outline", "none" ] }, "status": { "enum": [ "online", "offline", "busy", "away", "verified", "none" ] }, "statusLabel": { "type": "string" }, "emphasis": { "enum": [ "none", "ring", "halo" ] }, "emphasisColor": { "enum": [ "primary", "secondary", "tertiary", "base", "info", "success", "warning", "error", "dark", "light", "inverse", "none" ] }, "emphasisLabel": { "type": "string" }, "tooltip": { "type": "string" }, "ariaLabel": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "avatar-presentation-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.extra.imageSrc", "fieldMetadata.extra.imageAlt", "fieldMetadata.extra.initials", "fieldMetadata.extra.name", "fieldMetadata.extra.icon", "fieldMetadata.extra.defaultIcon", "fieldMetadata.extra.themeColor", "fieldMetadata.extra.rounded", "fieldMetadata.extra.size", "fieldMetadata.extra.fillMode", "fieldMetadata.extra.border", "fieldMetadata.extra.status", "fieldMetadata.extra.statusLabel", "fieldMetadata.extra.badge", "fieldMetadata.extra.badgeLabel", "fieldMetadata.extra.emphasis", "fieldMetadata.extra.emphasisColor", "fieldMetadata.extra.emphasisLabel", "fieldMetadata.extra.initialsMaxLength", "fieldMetadata.extra.tooltip", "fieldMetadata.extra.ariaLabel", "fieldMetadata.extra.groupLabel", "fieldMetadata.extra.groupMaxVisible", "fieldMetadata.extra.groupOverflowLabel", "fieldMetadata.extra.groupOverlap", "fieldMetadata.extra.groupItems" ], "submissionImpact": "visual-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "avatar-presentation-valid", "level": "error", "code": "PDFP023", "description": "Avatar controls must keep display metadata separate from submitted domain value semantics." } ], "examples": [ { "id": "configure-avatar-fields", "request": "Use Ada initials with verified presence, a compact corporate badge and selected reviewer emphasis.", "operationId": "field.avatar.configure", "params": { "extra": { "initials": "AL", "name": "Ada Lovelace", "defaultIcon": "person", "size": "large", "themeColor": "tertiary", "status": "verified", "statusLabel": "Verified profile", "badge": 3, "badgeLabel": "3 pending items", "emphasis": "ring", "emphasisColor": "success", "emphasisLabel": "Selected reviewer", "ariaLabel": "Avatar de Ada Lovelace" } }, "isPositive": true } ] }, { "profileId": "display-action", "title": "Display and action controls", "description": "Profile for non-data or action-like field controls.", "appliesTo": { "componentIds": [ "pdx-material-button", "pdx-preload-status" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Display/action metadata paths such as label, icon, action id, loading state and presentation mode." } ], "operations": [ { "operationId": "field.displayAction.configure", "title": "Configure display/action field metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "icon": { "type": "string" }, "actionId": { "type": "string" }, "presentationOnly": { "type": "boolean" }, "loadingStatePath": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "display-action-contract-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.icon", "fieldMetadata.actionId", "fieldMetadata.presentationOnly", "fieldMetadata.loadingStatePath" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "display-action-contract-valid", "level": "error", "code": "PDFP018", "description": "Display/action controls must not silently mutate submitted domain data unless an explicit action contract exists." } ], "examples": [ { "id": "configure-action-button", "request": "Configure a button field to trigger the refresh action.", "operationId": "field.displayAction.configure", "params": { "label": "Refresh", "icon": "refresh", "actionId": "refresh" }, "isPositive": true } ] }, { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ] }, "authoringManifestProfiles": [ { "profileId": "field-shell", "title": "Field shell controls", "description": "Profile for wrapper/shell controls that host another field contract.", "appliesTo": { "componentIds": [ "praxis-field-shell" ] }, "editableTargets": [ { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "description": "Shell metadata paths such as label, hint, error projection, layout and child control reference." } ], "operations": [ { "operationId": "field.shell.configure", "title": "Configure field shell metadata", "scope": "fieldMetadataPath", "targetKind": "fieldMetadataPath", "target": { "kind": "fieldMetadataPath", "resolver": "field-metadata-json-path", "ambiguityPolicy": "fail", "required": true }, "inputSchema": { "type": "object", "minProperties": 1, "properties": { "label": { "type": "string" }, "hint": { "type": "string" }, "errorMode": { "enum": [ "inline", "summary", "none" ] }, "childControlType": { "type": "string" } } }, "effects": [ { "kind": "merge-object", "path": "fieldMetadata" } ], "validators": [ "field-shell-child-valid", "field-metadata-compatible", "editor-tooling-discovers-control" ], "affectedPaths": [ "fieldMetadata.label", "fieldMetadata.hint", "fieldMetadata.errorMode", "fieldMetadata.childControlType" ], "submissionImpact": "config-only", "destructive": false, "requiresConfirmation": false, "preconditions": [ "field-metadata-initialized" ] } ], "validators": [ { "validatorId": "field-shell-child-valid", "level": "error", "code": "PDFP019", "description": "Field shell controls must delegate child semantics to the child control profile instead of redefining them." } ], "examples": [ { "id": "configure-field-shell-label", "request": "Set shell label and delegate rendering to inline select.", "operationId": "field.shell.configure", "params": { "label": "Status", "childControlType": "inlineSelect" }, "isPositive": true } ] } ], "chunks": [ { "chunkIndex": 0, "chunkKind": "summary", "content": "Component ID: praxis-field-shell\nSelector: praxis-field-shell\nFriendly Name: Field Shell (container)\nDescription: Invólucro visual/comportamental para campos dinâmicos (uso interno).\nLib/Package: @praxisui/dynamic-fields\nTags: internal, container, wrapper\nInputs:\n - field (FieldMetadata)\n - index (number)\n - control (AbstractControl | null)\n - readonlyMode (boolean)\n - disabledMode (boolean)\n - visible (boolean)\n - presentationMode (boolean)\n - canvasMode (boolean)\n", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/components/field-shell/field-shell.metadata.ts", "contentHash": "d0f2416e0227cc7939be65875a5373f71f7ff73a5b5c4adbf30465547958ea2e", "sourceKind": "component_definition", "sourceId": "praxis-field-shell", "corpusVersion": "1.0.0" }, { "chunkIndex": 1, "chunkKind": "capabilities", "content": "Schema Capabilities:\n - Path: id\n Category: identity\n Kind: string\n Description: Identificador unico da instancia do componente.\n - Path: version\n Category: identity\n Kind: string\n Description: Versao do schema de metadata (migracao).\n - Path: context\n Category: identity\n Kind: enum\n Description: Contexto de uso do componente (form/filter/table/dialog/standalone).\n - Path: createdAt\n Category: misc\n Kind: string\n Description: Timestamp de criacao (ISO).\n - Path: updatedAt\n Category: misc\n Kind: string\n Description: Timestamp de atualizacao (ISO).\n - Path: tags\n Category: identity\n Kind: array\n Description: Tags para categorizacao e busca.\n - Path: cssClass\n Category: appearance\n Kind: string\n Description: Classe CSS aplicada ao host do componente.\n - Path: style\n Category: appearance\n Kind: object\n Description: Estilos inline (objeto CSS).\n - Path: dataAttributes\n Category: data\n Kind: object\n Description: Data attributes para teste/analytics.\n - Path: name\n Category: identity\n Kind: string\n Description: Identificador único do campo. Essencial para binding.\n - Path: label\n Category: identity\n Kind: string\n Description: Rótulo principal exibido para o usuário.\n - Path: placeholder\n Category: identity\n Kind: string\n Description: Texto temporário exibido quando vazio.\n - Path: hint\n Category: identity\n Kind: string\n Description: Texto de ajuda exibido abaixo do campo.\n - Path: helpText\n Category: identity\n Kind: string\n Description: Texto semântico de ajuda publicado pelo schema/DTO.\n - Path: tooltip\n Category: identity\n Kind: string\n Description: Texto exibido ao passar o mouse.\n - Path: tooltipOnHover\n Category: identity\n Kind: boolean\n Description: Habilita apresentação do tooltip no hover quando suportado pelo renderer.\n - Path: description\n Category: identity\n Kind: string\n Description: Descrição detalhada (usada em documentação ou helps extensos).\n - Path: selectionMode\n Category: behavior\n Kind: enum\n Description: Semântica de seleção explícita para controles de escolha.\n - Path: variant\n Category: appearance\n Kind: string\n Description: Variante visual/semântica do controle.\n - Path: density\n Category: appearance\n Kind: enum\n Description: Densidade visual do shell do controle.\n - Path: links\n Category: identity\n Kind: array\n Description: Links ricos associados ao campo, úteis em consentimentos e conteúdo legal.\n - Path: group\n Category: identity\n Kind: string\n Description: Agrupador lógico do campo.\n - Path: order\n Category: layout\n Kind: number\n Description: Ordem de exibição do campo.\n - Path: width\n Category: layout\n Kind: string\n Description: Largura do campo (ex: 50%, 100px).\n - Path: isFlex\n Category: layout\n Kind: boolean\n Description: Se true, usa flex-grow para preencher espaço.\n - Path: controlType\n Category: behavior\n Kind: enum\n Description: Tipo do componente de UI (input, select, datepicker, etc).\n - Path: dataType\n Category: data\n Kind: enum\n Description: Tipo de dado do campo (text, number, date, etc).\n - Path: source\n Category: data\n Kind: enum\n Description: Origem semântica do campo. Use local para campos do host que não vêm do schema backend.\n - Path: transient\n Category: data\n Kind: boolean\n Description: Marca o campo como temporário/local para preenchimento. O dynamic-form omite do submit por padrão.\n - Path: submitPolicy\n Category: behavior\n Kind: enum\n Description: Política de submit para sobrescrever o padrão de campos locais/transient.\n - Path: materialDesign.appearance\n Category: appearance\n Kind: enum\n Description: Aparência do campo Material (fill/outline).\n - Path: materialDesign.color\n Category: appearance\n Kind: enum\n Description: Tema de cor Material (primary/accent/warn).\n - Path: materialDesign.floatLabel\n Category: appearance\n Kind: enum\n Description: Comportamento do rótulo flutuante.\n - Path: materialDesign.subscriptSizing\n Category: appearance\n Kind: enum\n Description: Estratégia de sizing do subscript (erros/hints).\n - Path: materialDesign.hideRequiredMarker\n Category: appearance\n Kind: boolean\n Description: Oculta o asterisco de campo obrigatório.\n - Path: materialDesign.density\n Category: appearance\n Kind: enum\n Description: Densidade do campo Material.\n - Path: materialDesign.disableRipple\n Category: appearance\n Kind: boolean\n Description: Desativa ripple/ondulação em componentes Material.\n - Path: materialDesign.customPalette\n Category: appearance\n Kind: object\n Description: Override de paleta (primary/accent/warn).\n - Path: materialDesign.animations\n Category: appearance\n Kind: object\n Description: Configuração de animações (disable, duration, easing).\n - Path: prefixIcon\n Category: appearance\n Kind: string\n Description: Ícone exibido antes do valor.\n - Path: suffixIcon\n Category: appearance\n Kind: string\n Description: Ícone exibido depois do valor.\n - Path: iconPosition\n Category: appearance\n Kind: enum\n Description: Posição preferencial do ícone principal.\n - Path: iconSize\n Category: appearance\n Kind: enum\n Description: Tamanho do ícone.\n - Path: iconColor\n Category: appearance\n Kind: string\n Description: Cor semântica ou token de cor aplicado ao ícone principal.\n - Path: iconClass\n Category: appearance\n Kind: string\n Description: Classe CSS controlada pelo host para o ícone principal.\n - Path: iconStyle\n Category: appearance\n Kind: string\n Description: Estilo visual semântico do ícone quando o renderer suportar variações.\n - Path: iconFontSize\n Category: appearance\n Kind: string\n Description: Tamanho tipográfico do ícone principal.\n - Path: valuePresentation\n Category: appearance\n Kind: object\n Description: Formato canonico de exibicao em superficies readonly/display, como moeda, numero, percentual, data, datetime, time e boolean.\n - Path: presentation\n Category: appearance\n Kind: object\n Description: Estado visual semantico base para presentationMode, incluindo presenter, tone, icon, label, badge, tooltip, appearance e formatter opcional.\n - Path: presentation.presenter\n Category: appearance\n Kind: enum\n Description: Tipo semantico de renderizacao em modo apresentacao.\n - Path: presentation.tone\n Category: appearance\n Kind: enum\n Description: Tom semantico mapeado pelo consumidor para tokens de tema.\n - Path: presentation.appearance\n Category: appearance\n Kind: enum\n Description: Nivel de enfase visual do apresentador.\n - Path: presentation.icon\n Category: appearance\n Kind: string\n Description: Nome de icone Material Symbols usado pelo apresentador semantico.\n - Path: presentation.label\n Category: identity\n Kind: string\n Description: Rotulo semantico exibido por apresentadores como status, badge ou chip.\n - Path: presentation.badge\n Category: appearance\n Kind: string\n Description: Marcador secundario opcional exibido junto ao valor em superficies de apresentacao.\n - Path: presentation.valuePresentation\n Category: appearance\n Kind: object\n Description: Override de formatacao aplicado apenas pela superficie de apresentacao.\n - Path: presentation.visualization\n Category: appearance\n Kind: object\n Description: Micro visualizacao renderer-neutral para superficies compactas como tabela, lista, header, card e form read-only.\n - Path: presentation.visualization.kind\n Category: appearance\n Kind: enum\n Description: Tipo semantico da micro visualizacao de apresentacao.\n - Path: presentation.visualization.surface\n Category: layout\n Kind: enum\n Description: Superficie alvo usada para aplicar regras de densidade e fallback.\n - Path: presentation.visualization.size\n Category: layout\n Kind: enum\n Description: Tamanho semantico da micro visualizacao.\n - Path: presentation.visualization.fallbackText\n Category: accessibility\n Kind: string\n Description: Texto equivalente obrigatorio para fallback, exportacao e leitores de tela.\n - Path: presentationRules\n Category: appearance\n Kind: array\n Description: Regras Json Logic ordenadas que sobrescrevem presentation em modo readonly/display; regras posteriores que casam vencem.\n - Path: presentationRules[].when\n Category: behavior\n Kind: object\n Description: Guarda Json Logic avaliada contra o contexto de apresentacao do campo.\n - Path: presentationRules[].set\n Category: appearance\n Kind: object\n Description: Patch semantico aplicado sobre presentation quando a guarda for verdadeira.\n - Path: mask\n Category: appearance\n Kind: string\n Description: Máscara de input (padrão do componente).\n - Path: format\n Category: appearance\n Kind: string\n Description: Formato de exibição (ex: pipes).\n - Path: validators\n Category: validation\n Kind: object\n Description: Objeto contendo todas as regras de validação.\n - Path: validators.required\n Category: validation\n Kind: boolean\n Description: Campo obrigatório.\n - Path: required\n Category: validation\n Kind: boolean\n Description: Campo obrigatório (alias rápido do validators.required).\n - Path: validators.requiredMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para required.\n - Path: validators.email\n Category: validation\n Kind: boolean\n Description: Validação de formato de e-mail.\n - Path: validators.emailMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para validação de email.\n - Path: validators.minLength\n Category: validation\n Kind: number\n Description: Comprimento mínimo do texto.\n - Path: validators.minLengthMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para minLength.\n - Path: validators.maxLength\n Category: validation\n Kind: number\n Description: Comprimento máximo do texto.\n - Path: validators.maxLengthMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para maxLength.\n - Path: validators.min\n Category: validation\n Kind: number\n Description: Valor numérico mínimo.\n - Path: validators.minMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para min.\n - Path: validators.max\n Category: validation\n Kind: number\n Description: Valor numérico máximo.\n - Path: validators.maxMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para max.\n - Path: validators.pattern\n Category: validation\n Kind: string\n Description: Regex para validação.\n - Path: validators.patternMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para pattern.\n - Path: validators.cpf\n Category: validation\n Kind: boolean\n Description: Validador de CPF (legado).\n - Path: validators.cnpj\n Category: validation\n Kind: boolean\n Description: Validador de CNPJ (legado).\n - Path: validators.cpfCnpj\n Category: validation\n Kind: boolean\n Description: Validador automatico CPF/CNPJ (legado).\n - Path: validators.cnpjAlpha\n Category: validation\n Kind: boolean\n Description: Validador de CNPJ alfanumerico (legado).\n - Path: validators.cpfMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CPF.\n - Path: validators.cnpjMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CNPJ.\n - Path: validators.cnpjAlphaMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para CNPJ alfanumerico.\n - Path: validators.url\n Category: validation\n Kind: boolean\n Description: Validador de URL.\n - Path: validators.urlMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para URL.\n - Path: validators.minWords\n Category: validation\n Kind: number\n Description: Mínimo de palavras.\n - Path: validators.requiredChecked\n Category: validation\n Kind: boolean\n Description: Exige checkbox marcado (ex: termos de uso).\n - Path: validators.customValidator\n Category: validation\n Kind: expression\n Description: Validador customizado (função).\n - Path: validators.asyncValidator\n Category: validation\n Kind: expression\n Description: Validador async customizado (função).\n - Path: validators.matchField\n Category: validation\n Kind: string\n Description: Campo que deve coincidir (cross-field).\n - Path: validators.matchFieldMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para matchField.\n - Path: validators.uniqueValidator\n Category: validation\n Kind: expression\n Description: Validador de unicidade via API (função).\n - Path: validators.uniqueMessage\n Category: validation\n Kind: string\n Description: Mensagem customizada para unicidade.\n - Path: validators.conditionalValidation\n Category: validation\n Kind: array\n Description: Regras de validação condicional.\n - Path: validators.conditionalValidation[].condition\n Category: validation\n Kind: expression\n Description: Condicao para aplicar validadores.\n - Path: validators.conditionalValidation[].validators\n Category: validation\n Kind: object\n Description: Conjunto de validadores aplicados quando a condicao for verdadeira.\n - Path: validators.validationTrigger\n Category: validation\n Kind: enum\n Description: Gatilho de validação no validator.\n - Path: validators.validationDebounce\n Category: validation\n Kind: number\n Description: Debounce de validação no validator (ms).\n - Path: validators.showInlineErrors\n Category: validation\n Kind: boolean\n Description: Exibe erros inline (validator).\n - Path: validators.errorPosition\n Category: validation\n Kind: enum\n Description: Posicao do erro (validator).\n - Path: validationMode\n Category: validation\n Kind: enum\n Description: Gatilho da validação (change/blur/submit).\n - Path: debounceTime\n Category: validation\n Kind: number\n Description: Debounce para validação em ms.\n - Path: options\n Category: data\n Kind: array\n Description: Array de opções conforme controlType (ex.: { key, value } ou { value, text/display }).\n - Path: endpoint\n Category: data\n Kind: string\n Description: URL para carregar opções remotas.\n - Path: valueField\n Category: data\n Kind: string\n Description: Nome da propriedade de valor nas opções.\n - Path: displayField\n Category: data\n Kind: string\n Description: Nome da propriedade de texto nas opções.\n - Path: filterField\n Category: data\n Kind: string\n Description: Campo para filtragem no backend.\n - Path: queryParams\n Category: data\n Kind: object\n Description: Parâmetros fixos para a query do endpoint.\n - Path: cacheDuration\n Category: data\n Kind: number\n Description: Duração do cache de dados em ms.\n - Path: hidden\n Category: behavior\n Kind: boolean\n Description: Oculta o campo globalmente.\n - Path: visibleIn\n Category: behavior\n Kind: array\n Description: Contextos onde o campo é visível.\n - Path: formHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas no formulário.\n - Path: tableHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas na tabela.\n - Path: filterHidden\n Category: behavior\n Kind: boolean\n Description: Oculta apenas no filtro.\n - Path: dependencyFields\n Category: dependency\n Kind: array\n Description: Campos dos quais este campo depende.\n - Path: conditionalRequired\n Category: dependency\n Kind: expression\n Description: Condição Json Logic para obrigatoriedade declarativa.\n - Path: conditionalDisplay\n Category: dependency\n Kind: expression\n Description: Condição Json Logic para visibilidade declarativa.\n - Path: dependencyFilterMap\n Category: dependency\n Kind: object\n Description: Mapeamento de filtro baseado na dependência.\n - Path: dependencyValuePath\n Category: dependency\n Kind: string\n Description: Caminho no valor da dependência.\n - Path: dependencyMergeStrategy\n Category: dependency\n Kind: enum\n Description: Estratégia de merge dos dados carregados.\n - Path: dependencyLoadOnChange\n Category: dependency\n Kind: enum\n Description: Quando recarregar dependência.\n - Path: resetOnDependentChange\n Category: dependency\n Kind: boolean\n Description: Zera valor se dependência mudar.\n - Path: enableDependencyCascade\n Category: dependency\n Kind: boolean\n Description: Habilita/desabilita cascata nativa de dependências entre campos.\n - Path: dependencyDebounceMs\n Category: dependency\n Kind: number\n Description: Delay para reagir à mudança de dependência.\n - Path: suppressInlineErrorsOnCascade\n Category: dependency\n Kind: boolean\n Description: Suprime erros inline durante cascata.\n - Path: transformDisplayValue\n Category: transform\n Kind: expression\n Description: Transforma valor para exibição.\n - Path: transformSaveValue\n Category: transform\n Kind: expression\n Description: Transforma valor para salvar.\n - Path: textTransformApply\n Category: transform\n Kind: enum\n Description: Quando aplicar transformação de texto.\n - Path: inlineEditing\n Category: behavior\n Kind: boolean\n Description: Permite edição inline (tabelas).\n - Path: unique\n Category: validation\n Kind: boolean\n Description: Valida unicidade no backend.\n - Path: readOnly\n Category: behavior\n Kind: boolean\n Description: Campo somente leitura.\n - Path: disabled\n Category: behavior\n Kind: boolean\n Description: Campo desabilitado.\n - Path: defaultValue\n Category: data\n Kind: object\n Description: Valor inicial do campo.\n - Path: ariaLabel\n Category: accessibility\n Kind: string\n Description: Label para leitores de tela.\n - Path: ariaDescribedBy\n Category: accessibility\n Kind: string\n Description: IDs de descrição acessível.\n - Path: tabIndex\n Category: accessibility\n Kind: number\n Description: Ordem de tabulacao para teclado.\n - Path: accessKey\n Category: accessibility\n Kind: string\n Description: Atalho de teclado (accessKey).\n", "sourcePointer": "praxis-ui-angular/projects/praxis-core/src/lib/ai/field-metadata-ai-capabilities.ts", "contentHash": "466e427814fe510e5b0108e418a13f828b5a363d3da46bf9b69be588c7088ce2", "sourceKind": "component_definition", "sourceId": "praxis-field-shell", "corpusVersion": "1.0.0" }, { "chunkIndex": 2, "chunkKind": "authoring_manifest", "content": "{\n \"schemaVersion\": \"1.0.0\",\n \"componentId\": \"praxis-dynamic-fields\",\n \"ownerPackage\": \"@praxisui/dynamic-fields\",\n \"configSchemaId\": \"FieldMetadata\",\n \"manifestVersion\": \"1.0.0\",\n \"runtimeInputs\": [\n {\n \"name\": \"fieldMetadata\",\n \"type\": \"FieldMetadata\",\n \"description\": \"Canonical field metadata consumed by dynamic field loaders.\"\n },\n {\n \"name\": \"controlType\",\n \"type\": \"FieldControlType\",\n \"description\": \"Control type resolved through ComponentRegistryService.\"\n },\n {\n \"name\": \"componentRegistry\",\n \"type\": \"ComponentRegistryService\",\n \"description\": \"Runtime registry for package-owned and host custom fields.\"\n },\n {\n \"name\": \"componentMetadataRegistry\",\n \"type\": \"ComponentMetadataRegistry\",\n \"description\": \"Editorial discovery registry for field tooling.\"\n }\n ],\n \"editableTargets\": [\n {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"description\": \"A canonical FieldControlType token.\"\n },\n {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"description\": \"Alias resolved through core control-type normalization.\"\n },\n {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"description\": \"Package-owned editorial descriptor in src/lib/editorial/**.\"\n },\n {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"description\": \"Selector-to-controlType mapping used by config-first flows.\"\n },\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"FieldMetadata capability path governed by @praxisui/core.\"\n },\n {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"description\": \"Runtime ComponentRegistryService coverage for a control type.\"\n },\n {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"description\": \"Metadata-editor and downstream tooling coverage for a control type.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"controlType.register\",\n \"title\": \"Register control type runtime support\",\n \"scope\": \"controlType\",\n \"targetKind\": \"controlType\",\n \"target\": {\n \"kind\": \"controlType\",\n \"resolver\": \"field-control-type-token\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\",\n \"default\": true\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-control-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"componentMetadata[]\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"componentRegistry\",\n \"componentMetadata[]\"\n ],\n \"identityKeys\": [\n \"controlType\",\n \"selector\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\",\n \"selector\",\n \"componentExport\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"selector\": {\n \"type\": \"string\"\n },\n \"componentExport\": {\n \"type\": \"string\"\n },\n \"lazyImportPath\": {\n \"type\": \"string\"\n },\n \"packageOwned\": {\n \"type\": \"boolean\"\n }\n }\n },\n \"failureModes\": [\n \"control-type-already-registered\",\n \"selector-already-registered\",\n \"runtime-component-unresolvable\"\n ],\n \"description\": \"Registers a package-owned control type in runtime and metadata registries using stable controlType and selector identities.\"\n }\n }\n ],\n \"validators\": [\n \"control-type-unique\",\n \"runtime-component-resolves\",\n \"field-metadata-compatible\"\n ],\n \"affectedPaths\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.add\",\n \"title\": \"Add control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": false\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-registration\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\",\n \"controlType\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"reason\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-already-registered\",\n \"target-control-type-unresolvable\",\n \"alias-normalizes-to-multiple-targets\"\n ],\n \"description\": \"Adds a deterministic control alias that normalizes to one registered canonical controlType.\"\n }\n }\n ],\n \"validators\": [\n \"alias-resolves-deterministically\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\"\n ]\n },\n {\n \"operationId\": \"controlType.alias.remove\",\n \"title\": \"Remove control type alias\",\n \"scope\": \"controlAlias\",\n \"targetKind\": \"controlAlias\",\n \"target\": {\n \"kind\": \"controlAlias\",\n \"resolver\": \"normalized-control-type-alias\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-alias-removal\",\n \"handlerContract\": {\n \"reads\": [\n \"controlTypeAliases\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"controlTypeAliases\"\n ],\n \"identityKeys\": [\n \"alias\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"alias\"\n ],\n \"properties\": {\n \"alias\": {\n \"type\": \"string\"\n },\n \"replacementControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"failureModes\": [\n \"alias-not-found\",\n \"replacement-control-type-unresolvable\",\n \"alias-still-referenced-without-replacement\"\n ],\n \"description\": \"Removes one alias by normalized alias identity after validating replacement coverage for downstream configs.\"\n }\n }\n ],\n \"destructive\": true,\n \"requiresConfirmation\": true,\n \"validators\": [\n \"alias-exists\",\n \"alias-removal-safe\",\n \"destructive-removal-confirmation\"\n ],\n \"affectedPaths\": [\n \"controlTypeAliases\"\n ],\n \"submissionImpact\": \"config-only\",\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"descriptor.update\",\n \"title\": \"Update editorial descriptor\",\n \"scope\": \"editorialDescriptor\",\n \"targetKind\": \"editorialDescriptor\",\n \"target\": {\n \"kind\": \"editorialDescriptor\",\n \"resolver\": \"component-metadata-editorial-descriptor\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"friendlyName\": {\n \"type\": \"string\"\n },\n \"description\": {\n \"type\": \"string\"\n },\n \"icon\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"string\"\n },\n \"recommendedWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"avoidWhen\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"i18nNamespace\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"editorialDescriptors[]\",\n \"key\": \"controlType\"\n }\n ],\n \"validators\": [\n \"descriptor-exists\",\n \"editorial-source-canonical\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"editorialDescriptors[]\",\n \"componentMetadata[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"selector.mapping.set\",\n \"title\": \"Set selector mapping\",\n \"scope\": \"selectorMapping\",\n \"targetKind\": \"selectorMapping\",\n \"target\": {\n \"kind\": \"selectorMapping\",\n \"resolver\": \"field-selector-registry-entry\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-selector-mapping-set\",\n \"handlerContract\": {\n \"reads\": [\n \"FieldSelectorRegistry\",\n \"DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP\",\n \"componentRegistry\"\n ],\n \"writes\": [\n \"FieldSelectorRegistry\"\n ],\n \"identityKeys\": [\n \"selector\",\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"selector\",\n \"controlType\"\n ],\n \"properties\": {\n \"selector\": {\n \"type\": \"string\"\n },\n \"controlType\": {\n \"type\": \"string\"\n },\n \"overwrite\": {\n \"type\": \"boolean\"\n },\n \"source\": {\n \"enum\": [\n \"package-default\",\n \"host-extension\"\n ]\n }\n }\n },\n \"failureModes\": [\n \"selector-already-mapped\",\n \"control-type-unresolvable\",\n \"selector-mapping-would-shadow-package-default\"\n ],\n \"description\": \"Maps a selector to a deterministic controlType through FieldSelectorRegistry without using host-only selector conventions.\"\n }\n }\n ],\n \"validators\": [\n \"selector-mapping-deterministic\",\n \"runtime-component-resolves\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"selectorMappings[]\",\n \"fieldMetadata.controlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"metadata.mapping.set\",\n \"title\": \"Set metadata path mapping\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"path\",\n \"valueKind\"\n ],\n \"properties\": {\n \"path\": {\n \"type\": \"string\"\n },\n \"valueKind\": {\n \"enum\": [\n \"string\",\n \"number\",\n \"boolean\",\n \"enum\",\n \"object\",\n \"array\",\n \"expression\"\n ]\n },\n \"controlTypes\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"required\": {\n \"type\": \"boolean\"\n },\n \"allowedValues\": {\n \"type\": \"array\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-by-key\",\n \"path\": \"fieldMetadataCapabilities[]\",\n \"key\": \"path\"\n }\n ],\n \"validators\": [\n \"field-metadata-compatible\",\n \"metadata-capability-aligned\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadataCapabilities[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"editorCoverage.validate\",\n \"title\": \"Validate editor coverage\",\n \"scope\": \"editorCoverage\",\n \"targetKind\": \"editorCoverage\",\n \"target\": {\n \"kind\": \"editorCoverage\",\n \"resolver\": \"metadata-editor-tooling-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-editor-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentMetadata[]\",\n \"editorialDescriptors[]\",\n \"fieldMetadataCapabilities[]\"\n ],\n \"writes\": [\n \"editorCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"metadataEditor\": {\n \"type\": \"boolean\"\n },\n \"dynamicFormDiscovery\": {\n \"type\": \"boolean\"\n },\n \"filterTooling\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"editor-coverage-missing\",\n \"dynamic-form-discovery-missing\",\n \"coverage-evidence-missing\"\n ],\n \"description\": \"Validates editor/tooling discovery for one controlType separately from runtime rendering support.\"\n }\n }\n ],\n \"validators\": [\n \"editor-tooling-discovers-control\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"editorCoverage\",\n \"componentMetadata[]\",\n \"editorialDescriptors[]\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n },\n {\n \"operationId\": \"runtimeCoverage.validate\",\n \"title\": \"Validate runtime coverage\",\n \"scope\": \"runtimeCoverage\",\n \"targetKind\": \"runtimeCoverage\",\n \"target\": {\n \"kind\": \"runtimeCoverage\",\n \"resolver\": \"component-registry-coverage\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"compile-domain-patch\",\n \"handler\": \"dynamic-fields-runtime-coverage-validation\",\n \"handlerContract\": {\n \"reads\": [\n \"componentRegistry\",\n \"fieldMetadata.controlType\"\n ],\n \"writes\": [\n \"runtimeCoverage\"\n ],\n \"identityKeys\": [\n \"controlType\"\n ],\n \"inputSchema\": {\n \"type\": \"object\",\n \"required\": [\n \"controlType\"\n ],\n \"properties\": {\n \"controlType\": {\n \"type\": \"string\"\n },\n \"componentRegistered\": {\n \"type\": \"boolean\"\n },\n \"valueAccessor\": {\n \"type\": \"boolean\"\n },\n \"hotMetadata\": {\n \"type\": \"boolean\"\n },\n \"evidence\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n },\n \"failureModes\": [\n \"runtime-component-unresolvable\",\n \"value-accessor-missing\",\n \"runtime-evidence-missing\"\n ],\n \"description\": \"Validates runtime registry and value-accessor coverage for one controlType without implying editor coverage.\"\n }\n }\n ],\n \"validators\": [\n \"runtime-component-resolves\",\n \"runtime-editor-coverage-not-divergent\",\n \"coverage-evidence-present\"\n ],\n \"affectedPaths\": [\n \"runtimeCoverage\",\n \"componentRegistry\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"registry-initialized\",\n \"target-exists\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"control-type-unique\",\n \"level\": \"error\",\n \"code\": \"PDF001\",\n \"description\": \"Package-owned control types must be unique and stable.\"\n },\n {\n \"validatorId\": \"runtime-component-resolves\",\n \"level\": \"error\",\n \"code\": \"PDF002\",\n \"description\": \"ComponentRegistryService must resolve the runtime component for the target controlType.\"\n },\n {\n \"validatorId\": \"field-metadata-compatible\",\n \"level\": \"error\",\n \"code\": \"PDF003\",\n \"description\": \"Control metadata must align with FieldMetadata semantics from @praxisui/core.\"\n },\n {\n \"validatorId\": \"alias-resolves-deterministically\",\n \"level\": \"error\",\n \"code\": \"PDF004\",\n \"description\": \"Aliases must normalize to a single canonical controlType.\"\n },\n {\n \"validatorId\": \"alias-exists\",\n \"level\": \"error\",\n \"code\": \"PDF005\",\n \"description\": \"Alias removal requires an existing alias target.\"\n },\n {\n \"validatorId\": \"alias-removal-safe\",\n \"level\": \"error\",\n \"code\": \"PDF006\",\n \"description\": \"Alias removal must provide migration or replacement when downstream configs may still use it.\"\n },\n {\n \"validatorId\": \"destructive-removal-confirmation\",\n \"level\": \"error\",\n \"code\": \"PDF007\",\n \"description\": \"Destructive alias removal requires explicit confirmation.\"\n },\n {\n \"validatorId\": \"descriptor-exists\",\n \"level\": \"error\",\n \"code\": \"PDF008\",\n \"description\": \"Editorial descriptor updates require an existing package-owned descriptor.\"\n },\n {\n \"validatorId\": \"editorial-source-canonical\",\n \"level\": \"error\",\n \"code\": \"PDF009\",\n \"description\": \"Package-owned editorial changes must originate in src/lib/editorial/**, not host overrides.\"\n },\n {\n \"validatorId\": \"editor-tooling-discovers-control\",\n \"level\": \"error\",\n \"code\": \"PDF010\",\n \"description\": \"Dynamic-form, metadata-editor and downstream tooling must discover the control metadata.\"\n },\n {\n \"validatorId\": \"metadata-capability-aligned\",\n \"level\": \"error\",\n \"code\": \"PDF011\",\n \"description\": \"Metadata mappings must align with FIELD_METADATA_CAPABILITIES and control-family capabilities.\"\n },\n {\n \"validatorId\": \"runtime-editor-coverage-not-divergent\",\n \"level\": \"error\",\n \"code\": \"PDF012\",\n \"description\": \"Runtime support and editor/tooling coverage must not diverge silently.\"\n },\n {\n \"validatorId\": \"coverage-evidence-present\",\n \"level\": \"error\",\n \"code\": \"PDF013\",\n \"description\": \"Coverage validation operations must include concrete evidence paths or spec names.\"\n },\n {\n \"validatorId\": \"selector-mapping-deterministic\",\n \"level\": \"error\",\n \"code\": \"PDF014\",\n \"description\": \"Selector mappings must resolve to one controlType through FieldSelectorRegistry and must not shadow package defaults implicitly.\"\n }\n ],\n \"roundTripRequirements\": [\n \"Runtime support, editorial descriptor, ComponentDocMeta and playground/catalog projection must remain aligned for package-owned fields.\",\n \"Aliases must resolve through the canonical core normalization path and must not become host-only conventions.\",\n \"Editor coverage and runtime coverage must be reported separately; runtime rendering alone is not sufficient evidence of editor/tooling support.\"\n ],\n \"examples\": [\n {\n \"id\": \"register-package-owned-control-type\",\n \"request\": \"Register a package-owned field control and make it runtime-resolvable.\",\n \"operationId\": \"controlType.register\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"selector\": \"pdx-my-control\",\n \"componentExport\": \"PdxMyControlComponent\",\n \"packageOwned\": true\n },\n \"isPositive\": true\n },\n {\n \"id\": \"add-control-alias\",\n \"request\": \"Allow legacy alias my-control to resolve to myControl.\",\n \"operationId\": \"controlType.alias.add\",\n \"params\": {\n \"alias\": \"my-control\",\n \"controlType\": \"myControl\",\n \"reason\": \"legacy schema compatibility\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"remove-control-alias-with-confirmation\",\n \"request\": \"Remove obsolete alias old-control after migration.\",\n \"operationId\": \"controlType.alias.remove\",\n \"target\": \"old-control\",\n \"params\": {\n \"alias\": \"old-control\",\n \"replacementControlType\": \"myControl\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"update-editorial-descriptor\",\n \"request\": \"Update friendly name and icon for a package-owned control.\",\n \"operationId\": \"descriptor.update\",\n \"target\": \"myControl\",\n \"params\": {\n \"friendlyName\": \"My Control\",\n \"icon\": \"widgets\",\n \"i18nNamespace\": \"dynamicFields\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-selector-mapping\",\n \"request\": \"Map pdx-my-control to myControl in the selector registry.\",\n \"operationId\": \"selector.mapping.set\",\n \"target\": \"pdx-my-control\",\n \"params\": {\n \"selector\": \"pdx-my-control\",\n \"controlType\": \"myControl\",\n \"source\": \"package-default\"\n },\n \"isPositive\": true\n },\n {\n \"id\": \"set-field-metadata-mapping\",\n \"request\": \"Publish a metadata capability path for option source mapping.\",\n \"operationId\": \"metadata.mapping.set\",\n \"target\": \"optionSource.dependsOn\",\n \"params\": {\n \"path\": \"optionSource.dependsOn\",\n \"valueKind\": \"array\",\n \"controlTypes\": [\n \"select\",\n \"entityLookup\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-editor-coverage\",\n \"request\": \"Prove that metadata editor and dynamic form can discover the control.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"metadataEditor\": true,\n \"dynamicFormDiscovery\": true,\n \"filterTooling\": false,\n \"evidence\": [\n \"component-metadata-registry.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"validate-runtime-coverage\",\n \"request\": \"Prove runtime registry and value accessor coverage.\",\n \"operationId\": \"runtimeCoverage.validate\",\n \"target\": \"myControl\",\n \"params\": {\n \"controlType\": \"myControl\",\n \"componentRegistered\": true,\n \"valueAccessor\": true,\n \"hotMetadata\": true,\n \"evidence\": [\n \"component-registry.service.spec.ts\"\n ]\n },\n \"isPositive\": true\n },\n {\n \"id\": \"reject-runtime-only-control\",\n \"request\": \"Mark a control supported because it renders, without editor metadata evidence.\",\n \"operationId\": \"editorCoverage.validate\",\n \"target\": \"runtimeOnlyControl\",\n \"params\": {\n \"controlType\": \"runtimeOnlyControl\",\n \"metadataEditor\": false,\n \"dynamicFormDiscovery\": false,\n \"evidence\": []\n },\n \"isPositive\": false\n }\n ],\n \"controlProfiles\": [\n {\n \"profileId\": \"field-shell\",\n \"title\": \"Field shell controls\",\n \"description\": \"Profile for wrapper/shell controls that host another field contract.\",\n \"appliesTo\": {\n \"componentIds\": [\n \"praxis-field-shell\"\n ]\n },\n \"editableTargets\": [\n {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"description\": \"Shell metadata paths such as label, hint, error projection, layout and child control reference.\"\n }\n ],\n \"operations\": [\n {\n \"operationId\": \"field.shell.configure\",\n \"title\": \"Configure field shell metadata\",\n \"scope\": \"fieldMetadataPath\",\n \"targetKind\": \"fieldMetadataPath\",\n \"target\": {\n \"kind\": \"fieldMetadataPath\",\n \"resolver\": \"field-metadata-json-path\",\n \"ambiguityPolicy\": \"fail\",\n \"required\": true\n },\n \"inputSchema\": {\n \"type\": \"object\",\n \"minProperties\": 1,\n \"properties\": {\n \"label\": {\n \"type\": \"string\"\n },\n \"hint\": {\n \"type\": \"string\"\n },\n \"errorMode\": {\n \"enum\": [\n \"inline\",\n \"summary\",\n \"none\"\n ]\n },\n \"childControlType\": {\n \"type\": \"string\"\n }\n }\n },\n \"effects\": [\n {\n \"kind\": \"merge-object\",\n \"path\": \"fieldMetadata\"\n }\n ],\n \"validators\": [\n \"field-shell-child-valid\",\n \"field-metadata-compatible\",\n \"editor-tooling-discovers-control\"\n ],\n \"affectedPaths\": [\n \"fieldMetadata.label\",\n \"fieldMetadata.hint\",\n \"fieldMetadata.errorMode\",\n \"fieldMetadata.childControlType\"\n ],\n \"submissionImpact\": \"config-only\",\n \"destructive\": false,\n \"requiresConfirmation\": false,\n \"preconditions\": [\n \"field-metadata-initialized\"\n ]\n }\n ],\n \"validators\": [\n {\n \"validatorId\": \"field-shell-child-valid\",\n \"level\": \"error\",\n \"code\": \"PDFP019\",\n \"description\": \"Field shell controls must delegate child semantics to the child control profile instead of redefining them.\"\n }\n ],\n \"examples\": [\n {\n \"id\": \"configure-field-shell-label\",\n \"request\": \"Set shell label and delegate rendering to inline select.\",\n \"operationId\": \"field.shell.configure\",\n \"params\": {\n \"label\": \"Status\",\n \"childControlType\": \"inlineSelect\"\n },\n \"isPositive\": true\n }\n ]\n }\n ]\n}", "sourcePointer": "praxis-ui-angular/projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts", "contentHash": "ab6a71f40127a46a2ee65bd16f17ce449ef2c00014f0cb7484206bf5766ab362", "sourceKind": "component_definition", "sourceId": "praxis-field-shell", "corpusVersion": "1.0.0" }, { "chunkIndex": 3, "chunkKind": "recipe", "content": "{\n \"_comment\": \"Recipe for praxis-field-shell | internal field wrapper\",\n \"templateMeta\": {\n \"registryKey\": \"praxis-field-shell\",\n \"tags\": [\n \"dynamic-fields\",\n \"internal\",\n \"container\"\n ],\n \"useWhen\": \"envolver campo com field shell\",\n \"examplePrompts\": [\n \"envolva um campo com field shell\",\n \"usar field shell no canvas\"\n ]\n },\n \"field\": {\n \"name\": \"example_input\",\n \"label\": \"Example input\",\n \"description\": \"example\",\n \"group\": \"example\",\n \"order\": 1,\n \"width\": \"example\",\n \"isFlex\": true,\n \"controlType\": \"input\",\n \"hidden\": false,\n \"formHidden\": false,\n \"tableHidden\": false,\n \"filterHidden\": false,\n \"readOnly\": true,\n \"disabled\": false,\n \"inlineEditing\": true,\n \"defaultValue\": \"default\",\n \"transformDisplayValue\": \"formValue.status == 'active'\",\n \"transformSaveValue\": \"formValue.status == 'active'\"\n },\n \"index\": 0,\n \"control\": null,\n \"readonlyMode\": false,\n \"disabledMode\": false,\n \"visible\": true,\n \"presentationMode\": false,\n \"canvasMode\": false,\n \"itemTemplate\": \"exampleItemTemplate\"\n}\n", "sourcePointer": "praxis-ui-angular/examples/ai-recipes/praxis-dynamic-fields/praxis-field-shell.json", "contentHash": "db3e0aab6d0e50cfaa0347629600ddacb64473677ccbfca6f64660f6f2aa7565", "sourceKind": "component_definition", "sourceId": "praxis-field-shell", "corpusVersion": "1.0.0" } ] } }, "note": "Package-scoped Praxis component registry for source-free agent discovery. Use the canonical ingestion registry for cross-package aggregate analysis." }