Praxis Fields Editorial Discovery
This praxis-fields-* plus praxis-dynamic-fields-editorial skill family is the canonical Codex skill surface for @praxisui/dynamic-fields and projects/praxis-dynamic-fields; do not create parallel dynamic-fields guidance unless this family cannot express a proven contract gap.
Use this skill when a field must be found, explained, configured, or selected by Praxis authoring tools. Runtime rendering alone is not enough for package-owned @praxisui/dynamic-fields controls.
When the discovery issue is downstream visual editing in @praxisui/metadata-editor, use
praxis-metadata-editor-renderer-coverage to audit FieldMetadataEditorComponent,
DynamicEditorRendererComponent, EditorProperty[] configs, and JSON-only fallback claims. When the
same field depends on optionSource, cascade, remote-source, or schema-normalizer behavior, pair it
with praxis-metadata-editor-cascade-normalization.
When locating files, first resolve the Angular workspace root. Paths below are relative to
praxis-ui-angular/projects/praxis-dynamic-fields unless another package is explicitly named.
Canonical Discovery Chain
For package-owned fields, keep this chain coherent:
- runtime component and
ComponentRegistryService registration
- component
*.metadata.ts and the matching editorial descriptor in src/lib/editorial/**
PRAXIS_DYNAMIC_FIELDS_WAVE_1_COMPONENT_METADATA plus PRAXIS_DYNAMIC_FIELDS_EDITORIAL_WAVE_1
ComponentMetadataRegistry.register(...) and registerEditorial(...)
- generated/derived
ComponentDocMeta
DYNAMIC_FIELDS_PLAYGROUND_CATALOG derivation, inventory docs, and field selection guidance
- AI authoring surfaces:
CONTROL_TYPE_AI_CATALOGS, authoring profiles, and PRAXIS_DYNAMIC_FIELDS_AUTHORING_MANIFEST
- downstream consumers:
@praxisui/metadata-editor, @praxisui/dynamic-form, praxis-filter, landing examples, AI registry
Host custom fields may register ComponentDocMeta through the host registry. Package-owned fields should not be solved by host-only metadata patches.
Required Inventory
Inspect:
src/lib/editorial/dynamic-fields-wave-1.registry.ts
- affected
src/lib/editorial/wave1/*.editorial.ts
- affected component
*.metadata.ts
src/lib/catalog/dynamic-fields-playground.catalog.ts
src/lib/catalog/dynamic-fields-playground.catalog.spec.ts
src/lib/catalog/catalog-derivation.spec.ts
src/lib/editorial/metadata-contract.spec.ts
src/lib/editorial/metadata-i18n-contract.spec.ts
src/lib/ai/control-type-ai-catalog.ts and spec when discovery affects AI control capability lookup
src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts and spec when discovery affects AI-editable targets, operations, or registry ingestion
src/lib/ai/praxis-dynamic-fields-authoring-profiles.ts when per-control authoring capability text changes
src/lib/i18n/dynamic-fields.*.ts
- docs: inventory, field catalog, field selection guide, host custom field guide, inline filter catalog/contract where relevant
Editorial Rules
- Friendly name, description, icon, family, track, tags, and inputs for package-owned controls belong in the canonical descriptor/metadata source, not in a downstream editor map.
- If a control is visible in runtime but missing in metadata editor, dynamic form builder, or playground, fix the registry/discovery chain rather than adding a consumer-local list.
- Keep
ComponentDocMeta.id, componentType, descriptor controlType, selector, descriptor component reference, icon, lib, inputs, outputs, and runtime registration aligned.
- Keep
PRAXIS_DYNAMIC_FIELDS_WAVE_1_COMPONENT_METADATA and PRAXIS_DYNAMIC_FIELDS_EDITORIAL_WAVE_1 in the same semantic order unless you deliberately update the contract spec.
- Catalog entries should derive canonical friendly name, description, and descriptor icon from the editorial registry. Keep showcase-only data local to the catalog: recommended/avoid guidance, preview seeds, presets, snippets, interaction pattern overrides, and docs slugs.
- Treat the exported playground catalog as operational discovery, not a loose documentation table. Every published
controlType must stay unique, use canonical non-alias identity, derive editorial copy/icon from the wave registry, keep previewRecipe.baseMetadata.controlType aligned, and resolve through the default ComponentRegistryService; otherwise classify the entry as partial discovery rather than a supported published choice.
- Editorial/catalog parity proves discoverability, not full behavior. If the descriptor or catalog advertises remote options, entity lookup, inline explicit overlays, runtime hot metadata, selected reload, or AI authoring readiness, also prove the owning runtime/profile/option-source skill evidence instead of treating catalog presence as support.
- Keep i18n coverage in sync when editorial copy changes; do not add English-only copy for a package-owned control unless the package already treats it as technical-only.
- When a documentation projector consumes installed
@praxisui/dynamic-fields component-registry metadata, resolve friendlyName and description values that are i18n keys through the public canonical dictionary from the same pinned release (PRAXIS_DYNAMIC_FIELDS_PT_BR), or fail with the unresolved key. Do not copy translations into the host or create a second translation runtime.
- A registry name or ID is discovery metadata, not an import instruction and not proof that the component has runtime integration. Preserve that boundary in public catalog copy and validation.
- Preserve the distinction between primary form controls and specialized inline filter controls. Inline controls should not appear as default corporate form choices unless the authoring context is filter-focused.
- Do not publish compatibility aliases as primary authoring choices. Aliases may support ingestion or migration, but catalog choices should be canonical
FieldControlType values.
- Keep public docs and exported catalog aligned with runtime and editorial truth. Markdown explains; the package catalog should drive official host/playground discovery.
- When a control becomes AI-discoverable, align
CONTROL_TYPE_AI_CATALOGS, authoring profiles, and PRAXIS_DYNAMIC_FIELDS_AUTHORING_MANIFEST validators/targets so AI authoring resolves the same canonical control identity as runtime/editorial discovery.
- If a package-owned field is only discoverable through host-local metadata, manual docs, or downstream editor config, classify it as partial discovery and fix the canonical descriptor/metadata registry path before updating public guidance.
Integration With Other Skills
- Use
praxis-fields-runtime-loader for loader, registry, selector, or hot metadata behavior.
- Use
praxis-fields-option-sources for optionSource, async select, searchable select, and entity lookup behavior.
- Use
praxis-fields-ai-canvas-validation when the change affects AI manifests, component profiles, canvas integration, or generated registry ingestion.
- Use
praxis-fields-control-profile-ai when the field needs per-control AI profile or capability coverage.
- Use
praxis-fields-inline-overlay-runtime when the discovery claim is about inline filter controls, inlineOverlay, compact pills, or overlay actions.
- Use
praxis-fields-text-number-time-controls or praxis-fields-selection-lookup-controls when discovery must preserve the semantics of a specific control family.
- Use
praxis-authoring-editors when downstream metadata editor behavior must be changed.
- Use
praxis-metadata-editor-renderer-coverage when the downstream behavior is specifically metadata-editor visual coverage or renderer parity.
Validation
Prefer focused checks:
- editorial descriptors:
npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/editorial/metadata-contract.spec.ts
- i18n:
npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/editorial/metadata-i18n-contract.spec.ts
- catalogs:
npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/catalog/catalog-derivation.spec.ts --include=projects/praxis-dynamic-fields/src/lib/catalog/dynamic-fields-playground.catalog.spec.ts
- This catalog gate proves both derivation from editorial metadata and registry resolvability for every published catalog
controlType; do not replace it with markdown-only review when changing official discovery.
- AI authoring discovery:
npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/ai/control-type-ai-catalog.spec.ts --include=projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.spec.ts
- downstream discovery: metadata-editor or dynamic-form specs only when the consumer behavior changed
- Add runtime/profile/option-source/inline overlay focused checks when the discovery change claims those behaviors; editorial/catalog specs alone only prove the field can be found and described.
The change is incomplete if a package-owned field renders but cannot be found with the right name, icon, tags, inputs, and usage guidance in authoring tooling.
1---2name: praxis-fields-editorial-discovery3description: Use when changing @praxisui/dynamic-fields or praxis-dynamic-fields package editorial descriptors, ComponentMetadataRegistry entries, component doc metadata, field catalogs, inventory, metadata-editor/dynamic-form discovery, i18n copy, control friendly names/icons/tags, or any case where a field renders at runtime but must also be discoverable by authoring tools.4metadata:5 source: https://skillmd.com/skills/codexrodrigues/praxis-fields-editorial-discovery6---78# Praxis Fields Editorial Discovery910This `praxis-fields-*` plus `praxis-dynamic-fields-editorial` skill family is the canonical Codex skill surface for `@praxisui/dynamic-fields` and `projects/praxis-dynamic-fields`; do not create parallel dynamic-fields guidance unless this family cannot express a proven contract gap.1112Use this skill when a field must be found, explained, configured, or selected by Praxis authoring tools. Runtime rendering alone is not enough for package-owned `@praxisui/dynamic-fields` controls.1314When the discovery issue is downstream visual editing in `@praxisui/metadata-editor`, use15`praxis-metadata-editor-renderer-coverage` to audit `FieldMetadataEditorComponent`,16`DynamicEditorRendererComponent`, `EditorProperty[]` configs, and JSON-only fallback claims. When the17same field depends on `optionSource`, cascade, remote-source, or schema-normalizer behavior, pair it18with `praxis-metadata-editor-cascade-normalization`.1920When locating files, first resolve the Angular workspace root. Paths below are relative to21`praxis-ui-angular/projects/praxis-dynamic-fields` unless another package is explicitly named.2223## Canonical Discovery Chain2425For package-owned fields, keep this chain coherent:26271. runtime component and `ComponentRegistryService` registration282. component `*.metadata.ts` and the matching editorial descriptor in `src/lib/editorial/**`293. `PRAXIS_DYNAMIC_FIELDS_WAVE_1_COMPONENT_METADATA` plus `PRAXIS_DYNAMIC_FIELDS_EDITORIAL_WAVE_1`304. `ComponentMetadataRegistry.register(...)` and `registerEditorial(...)`315. generated/derived `ComponentDocMeta`326. `DYNAMIC_FIELDS_PLAYGROUND_CATALOG` derivation, inventory docs, and field selection guidance337. AI authoring surfaces: `CONTROL_TYPE_AI_CATALOGS`, authoring profiles, and `PRAXIS_DYNAMIC_FIELDS_AUTHORING_MANIFEST`348. downstream consumers: `@praxisui/metadata-editor`, `@praxisui/dynamic-form`, `praxis-filter`, landing examples, AI registry3536Host custom fields may register `ComponentDocMeta` through the host registry. Package-owned fields should not be solved by host-only metadata patches.3738## Required Inventory3940Inspect:4142- `src/lib/editorial/dynamic-fields-wave-1.registry.ts`43- affected `src/lib/editorial/wave1/*.editorial.ts`44- affected component `*.metadata.ts`45- `src/lib/catalog/dynamic-fields-playground.catalog.ts`46- `src/lib/catalog/dynamic-fields-playground.catalog.spec.ts`47- `src/lib/catalog/catalog-derivation.spec.ts`48- `src/lib/editorial/metadata-contract.spec.ts`49- `src/lib/editorial/metadata-i18n-contract.spec.ts`50- `src/lib/ai/control-type-ai-catalog.ts` and spec when discovery affects AI control capability lookup51- `src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts` and spec when discovery affects AI-editable targets, operations, or registry ingestion52- `src/lib/ai/praxis-dynamic-fields-authoring-profiles.ts` when per-control authoring capability text changes53- `src/lib/i18n/dynamic-fields.*.ts`54- docs: inventory, field catalog, field selection guide, host custom field guide, inline filter catalog/contract where relevant5556## Editorial Rules5758- Friendly name, description, icon, family, track, tags, and inputs for package-owned controls belong in the canonical descriptor/metadata source, not in a downstream editor map.59- If a control is visible in runtime but missing in metadata editor, dynamic form builder, or playground, fix the registry/discovery chain rather than adding a consumer-local list.60- Keep `ComponentDocMeta.id`, `componentType`, descriptor `controlType`, selector, descriptor component reference, icon, lib, inputs, outputs, and runtime registration aligned.61- Keep `PRAXIS_DYNAMIC_FIELDS_WAVE_1_COMPONENT_METADATA` and `PRAXIS_DYNAMIC_FIELDS_EDITORIAL_WAVE_1` in the same semantic order unless you deliberately update the contract spec.62- Catalog entries should derive canonical friendly name, description, and descriptor icon from the editorial registry. Keep showcase-only data local to the catalog: recommended/avoid guidance, preview seeds, presets, snippets, interaction pattern overrides, and docs slugs.63- Treat the exported playground catalog as operational discovery, not a loose documentation table. Every published `controlType` must stay unique, use canonical non-alias identity, derive editorial copy/icon from the wave registry, keep `previewRecipe.baseMetadata.controlType` aligned, and resolve through the default `ComponentRegistryService`; otherwise classify the entry as partial discovery rather than a supported published choice.64- Editorial/catalog parity proves discoverability, not full behavior. If the descriptor or catalog advertises remote options, entity lookup, inline explicit overlays, runtime hot metadata, selected reload, or AI authoring readiness, also prove the owning runtime/profile/option-source skill evidence instead of treating catalog presence as support.65- Keep i18n coverage in sync when editorial copy changes; do not add English-only copy for a package-owned control unless the package already treats it as technical-only.66- When a documentation projector consumes installed `@praxisui/dynamic-fields` component-registry metadata, resolve `friendlyName` and `description` values that are i18n keys through the public canonical dictionary from the same pinned release (`PRAXIS_DYNAMIC_FIELDS_PT_BR`), or fail with the unresolved key. Do not copy translations into the host or create a second translation runtime.67- A registry name or ID is discovery metadata, not an import instruction and not proof that the component has runtime integration. Preserve that boundary in public catalog copy and validation.68- Preserve the distinction between primary form controls and specialized inline filter controls. Inline controls should not appear as default corporate form choices unless the authoring context is filter-focused.69- Do not publish compatibility aliases as primary authoring choices. Aliases may support ingestion or migration, but catalog choices should be canonical `FieldControlType` values.70- Keep public docs and exported catalog aligned with runtime and editorial truth. Markdown explains; the package catalog should drive official host/playground discovery.71- When a control becomes AI-discoverable, align `CONTROL_TYPE_AI_CATALOGS`, authoring profiles, and `PRAXIS_DYNAMIC_FIELDS_AUTHORING_MANIFEST` validators/targets so AI authoring resolves the same canonical control identity as runtime/editorial discovery.72- If a package-owned field is only discoverable through host-local metadata, manual docs, or downstream editor config, classify it as partial discovery and fix the canonical descriptor/metadata registry path before updating public guidance.7374## Integration With Other Skills7576- Use `praxis-fields-runtime-loader` for loader, registry, selector, or hot metadata behavior.77- Use `praxis-fields-option-sources` for `optionSource`, async select, searchable select, and entity lookup behavior.78- Use `praxis-fields-ai-canvas-validation` when the change affects AI manifests, component profiles, canvas integration, or generated registry ingestion.79- Use `praxis-fields-control-profile-ai` when the field needs per-control AI profile or capability coverage.80- Use `praxis-fields-inline-overlay-runtime` when the discovery claim is about inline filter controls, `inlineOverlay`, compact pills, or overlay actions.81- Use `praxis-fields-text-number-time-controls` or `praxis-fields-selection-lookup-controls` when discovery must preserve the semantics of a specific control family.82- Use `praxis-authoring-editors` when downstream metadata editor behavior must be changed.83- Use `praxis-metadata-editor-renderer-coverage` when the downstream behavior is specifically metadata-editor visual coverage or renderer parity.8485## Validation8687Prefer focused checks:8889- editorial descriptors:90 - `npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/editorial/metadata-contract.spec.ts`91- i18n:92 - `npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/editorial/metadata-i18n-contract.spec.ts`93- catalogs:94 - `npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/catalog/catalog-derivation.spec.ts --include=projects/praxis-dynamic-fields/src/lib/catalog/dynamic-fields-playground.catalog.spec.ts`95 - This catalog gate proves both derivation from editorial metadata and registry resolvability for every published catalog `controlType`; do not replace it with markdown-only review when changing official discovery.96- AI authoring discovery:97 - `npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/ai/control-type-ai-catalog.spec.ts --include=projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.spec.ts`98- downstream discovery: metadata-editor or dynamic-form specs only when the consumer behavior changed99- Add runtime/profile/option-source/inline overlay focused checks when the discovery change claims those behaviors; editorial/catalog specs alone only prove the field can be found and described.100101The change is incomplete if a package-owned field renders but cannot be found with the right name, icon, tags, inputs, and usage guidance in authoring tooling.