Praxis Fields AI Canvas Validation
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 to prove that @praxisui/dynamic-fields knowledge is available to AI-assisted authoring and canvas/editor surfaces. This is the validation layer for decisions, not a place to invent field semantics.
For focused profile work, use praxis-fields-control-profile-ai. For inline overlay recipes or
compact filter semantics, use praxis-fields-inline-overlay-runtime. For family-specific control
semantics, use praxis-fields-text-number-time-controls or
praxis-fields-selection-lookup-controls before updating AI catalogs or registry projections.
When locating files, first resolve the Angular workspace root. Paths below are relative to
praxis-ui-angular/projects/praxis-dynamic-fields unless they explicitly start with tools/,
examples/, dist/, or another package path.
Canonical AI/Canvas Surfaces
Inspect the actual sources:
src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts
src/lib/ai/praxis-dynamic-fields-authoring-profiles.ts
src/lib/ai/control-type-ai-catalog.ts
- relevant
src/lib/ai/*-ai-capabilities.ts capability families for the changed control family
src/lib/catalog/dynamic-fields-playground.catalog.ts
src/lib/catalog/dynamic-fields-playground.recipes.ts
src/lib/canvas-integration/canvas-state.token.ts
src/lib/services/component-registry/component-registry.service.ts
src/lib/editorial/dynamic-fields-wave-1.registry.ts
- component
*.metadata.ts files and colocated *.json-api.md files for the changed controls
docs/dynamic-fields-field-catalog.md
docs/dynamic-fields-field-selection-guide.md
docs/dynamic-fields-inline-filter-runtime-contract.md
docs/dynamic-fields-inventory.md
docs/dynamic-fields-playground-catalog-plan.md
docs/dynamic-fields-host-custom-field-guide.md when host/custom-field behavior is involved
tools/ai-registry/extract-component-docs.js
tools/ai-registry/generate-registry-ingestion.ts
tools/ai-registry/validate-catalog-governance.js
tools/ai-registry/validate-authoring-contracts-acceptance.js
tools/ai-registry/component-docs.json
dist/praxis-component-registry-ingestion.json when present or generated for the task
dist/ai-registry-catalog-validation-report.json and .md when catalog governance is validated
dist/authoring-contracts-acceptance-gate-report.json and .md when authoring acceptance is validated
examples/ai-recipes/praxis-dynamic-fields/*.json when recipe projection changes
- generated AI registry artifacts when the task requires registry ingestion proof
The family manifest should capture shared FieldMetadata, registry, and editorial semantics. Component profiles should express per-control differences such as text, numeric, option, temporal, upload, display, and entity-lookup behavior.
The playable catalog is the canonical host/canvas projection for discovery and preview. Hosts, landing pages, playgrounds, and canvas surfaces should derive menus, cards, preview recipes, icons, snippets, and doc links from the exported catalog instead of maintaining manual lists. Markdown docs explain the contract; they must not be parsed as the runtime source of truth.
CANVAS_STATE_SERVICE is intentionally a projection boundary. It stores hovered/selected
CanvasElementData, the DOM element, canonical FieldMetadata, and a field path. It must not own
control semantics, aliases, option-source contracts, runtime registration, or profile behavior.
Required Reasoning
For each AI/canvas change, answer:
- What canonical semantic decision is being authored?
- Which runtime/editorial source proves the field exists?
- Which profile or capability tells AI how to choose, configure, or avoid the field?
- Which materialization is derived: catalog, recipe, component docs, metadata editor, canvas state, or runtime preview?
- What would fail if the AI only emitted JSON without grounding in the registry/catalog?
- Which evidence is only a projection? A selected canvas element, playable catalog card, generated ingestion chunk, or preview recipe can point to canonical metadata, but none of them independently author control semantics, option-source contracts, selector aliases, or runtime registration.
- Which evidence statuses are complete, partial, or intentionally skipped: runtime registry, metadata registry, profile/capability, playable catalog, canvas state, registry ingestion, docs, and downstream consumers?
- If the authored decision is
controlType.alias.add, which canonical alias owner changes?
PRAXIS_DYNAMIC_FIELDS_AUTHORING_MANIFEST exposes the operation so AI can reason about the
decision, but the implementation path must prove @praxisui/core alias normalization first
(resolveControlTypeAlias(...) / normalizeControlTypeToken(...)) before treating
ComponentRegistryService fallback synonyms, generated registry chunks, or canvas state as
evidence. A runtime-only alias is partial AI/canvas coverage.
Do not use keyword routing as the primary way to pick a field. AI authoring should ground the user intent into canonical control types, option-source contracts, component profiles, and declared tools/catalogs.
Coverage Rules
- Do not duplicate a full manifest per runtime control when a family manifest plus component-level profile is enough.
- Do not claim AI coverage for a package-owned field unless the registry extractor can see either literal
ComponentDocMeta or a supported editorial factory such as createWave1ComponentDocMeta(descriptor).
- Keep runtime coverage, editorial discovery, AI profile coverage, canvas/playground coverage, generated registry coverage, and docs coverage as separate statuses.
- Registry extraction must prove component docs shape, unique component ids/selectors, expected source metadata, generated ingestion schema, capability chunks, and authoring manifest chunks. Do not treat generated JSON as trusted unless the governance validators pass.
- Authoring acceptance must keep
praxis-dynamic-fields as a family component with the expected manifest terms, minimum operations/editable targets/validators/examples/control profiles, report sections, and semantic validation evidence.
- Validate option-source and entity lookup controls with
praxis-fields-option-sources; AI should understand by-ids reload, dependencies, and partial backend waivers instead of authoring a local select workaround.
- Validate AI profile claims with
praxis-fields-control-profile-ai; canvas/registry evidence is incomplete when runtime coverage depends on fallback normalization, when select/entity examples omit governed by-ids/reload evidence, or when inline explicit overlays omit draft/apply/cancel semantics.
- Keep canvas integration as a projection of field metadata/editorial state. Do not create a second concept layer for canvas-only field behavior when the canonical registry already knows it.
- Canvas state may store selection, hover, focus, draft validation, preview state, DOM reference, and field path, but it must not become the canonical owner of control semantics, metadata shape, aliases, option-source rules, or runtime registration.
- A playable catalog entry is incomplete if its
controlType is not resolvable by the default ComponentRegistryService, unless it is explicitly marked as experimental or host-owned.
- A playable catalog entry is discovery evidence only after it aligns with runtime registration, editorial descriptor/component metadata, profile/capability coverage, and preview recipe. Catalog parity tests are necessary but do not replace option-source, loader, or profile-family validation.
- A preview recipe is incomplete if it demonstrates a control with metadata paths or value shapes not supported by the profile, capability, runtime component, or metadata editor contract. For remote lookup and inline controls, also prove selected-value hydration/by-ids or explicit Apply/Cancel/Clear semantics when those are part of the canonical behavior.
- Alias authoring is incomplete if the manifest operation, generated ingestion chunk, or canvas affordance
can name an alias that only
ComponentRegistryService resolves. The AI/canvas proof must include
core alias normalization and downstream discoverability so generated authoring does not produce a
control identity that renders in preview but fails metadata-editor, catalog, docs, or registry
governance.
- Docs and inventories should reference the exported catalog and registry chain. If a host needs custom fields, it may register its own runtime and metadata entries, but it must not override the platform catalog to redefine package-owned semantics.
- For wrapper controls, AI/canvas may choose and place the field through dynamic-fields, but package-specific policy must come from the owning package AI/runtime skill.
Inventory Before New Contract
ja-suportado-so-ux: registry/profile/catalog evidence exists, but canvas, playground, assistant UI, or docs do not expose it clearly.
ja-suportado-mal-nomeado-ou-mal-materializado: the canvas or docs use labels, aliases, or manual seeds while the exported catalog already has canonical controlType, interaction pattern, icon, snippet, and doc link.
suportado-parcialmente: some projections exist, but runtime registry, metadata registry, AI profile, capability family, playable catalog, registry ingestion, or docs are not all in sync.
lacuna-real-de-contrato: no canonical manifest target, profile operation, runtime/editorial registration, catalog entry, or registry ingestion path can represent the field decision.
Only lacuna-real-de-contrato justifies new contract work. Otherwise, repair the missing projection and validation gate in the existing chain.
Validation
Prefer focused checks:
npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.spec.ts --include=projects/praxis-dynamic-fields/src/lib/ai/control-type-ai-catalog.spec.ts --include=projects/praxis-dynamic-fields/src/lib/ai/inline-filter-recipes.spec.ts when manifest, control catalog, capability profile, or inline recipes change.
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 when playable catalog, preview recipe, discovery materialization, snippets, icons, doc links, or registry parity change.
npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/editorial/metadata-contract.spec.ts --include=projects/praxis-dynamic-fields/src/lib/editorial/metadata-i18n-contract.spec.ts when metadata/editorial coverage or docs-facing metadata changes.
npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/services/component-registry/component-registry.service.spec.ts --include=projects/praxis-dynamic-fields/src/lib/directives/dynamic-field-loader.directive.spec.ts when runtime registration, loader, or preview resolution changes.
- Add the focused dynamic-field loader specs for metadata refresh, presentation mode, select rebind, skip snapshot, or global states when the canvas/preview workflow depends on those paths.
npm run generate:registry:ingestion when generated component docs, AI metadata, catalog governance, authoring contracts, or registry ingestion can change.
node tools/ai-registry/validate-catalog-governance.js when component docs or ingestion artifacts are generated or consumed as evidence.
node tools/ai-registry/validate-authoring-contracts-acceptance.js when authoring manifest acceptance, semantic reports, or registry ingestion acceptance is in scope.
npm run validate:published-doc-assets when public docs or generated docs assets reflect the changed AI/canvas surface.
npm run build:praxis-dynamic-fields when public exports, catalog exports, profile constants, registry metadata, or runtime registration change.
For canvas-facing work, also verify that the field can be discovered, selected, configured, previewed, and projected into dynamic-form/metadata-editor consumers through the canonical runtime/editorial chain. A static manifest entry without runtime/editorial proof is not enough.
1---2name: praxis-fields-ai-canvas-validation3description: Use when changing or auditing @praxisui/dynamic-fields or praxis-dynamic-fields package AI authoring manifest, control-type AI catalog, authoring profiles, AI registry ingestion, canvas integration tokens, playground recipes, generated component docs, or validation that dynamic field runtime/editorial/canvas coverage is actually available to AI-assisted authoring.4metadata:5 source: https://skillmd.com/skills/codexrodrigues/praxis-fields-ai-canvas-validation6---78# Praxis Fields AI Canvas Validation910This `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 to prove that `@praxisui/dynamic-fields` knowledge is available to AI-assisted authoring and canvas/editor surfaces. This is the validation layer for decisions, not a place to invent field semantics.1314For focused profile work, use `praxis-fields-control-profile-ai`. For inline overlay recipes or15compact filter semantics, use `praxis-fields-inline-overlay-runtime`. For family-specific control16semantics, use `praxis-fields-text-number-time-controls` or17`praxis-fields-selection-lookup-controls` before updating AI catalogs or registry projections.1819When locating files, first resolve the Angular workspace root. Paths below are relative to20`praxis-ui-angular/projects/praxis-dynamic-fields` unless they explicitly start with `tools/`,21`examples/`, `dist/`, or another package path.2223## Canonical AI/Canvas Surfaces2425Inspect the actual sources:2627- `src/lib/ai/praxis-dynamic-fields-authoring-manifest.ts`28- `src/lib/ai/praxis-dynamic-fields-authoring-profiles.ts`29- `src/lib/ai/control-type-ai-catalog.ts`30- relevant `src/lib/ai/*-ai-capabilities.ts` capability families for the changed control family31- `src/lib/catalog/dynamic-fields-playground.catalog.ts`32- `src/lib/catalog/dynamic-fields-playground.recipes.ts`33- `src/lib/canvas-integration/canvas-state.token.ts`34- `src/lib/services/component-registry/component-registry.service.ts`35- `src/lib/editorial/dynamic-fields-wave-1.registry.ts`36- component `*.metadata.ts` files and colocated `*.json-api.md` files for the changed controls37- `docs/dynamic-fields-field-catalog.md`38- `docs/dynamic-fields-field-selection-guide.md`39- `docs/dynamic-fields-inline-filter-runtime-contract.md`40- `docs/dynamic-fields-inventory.md`41- `docs/dynamic-fields-playground-catalog-plan.md`42- `docs/dynamic-fields-host-custom-field-guide.md` when host/custom-field behavior is involved43- `tools/ai-registry/extract-component-docs.js`44- `tools/ai-registry/generate-registry-ingestion.ts`45- `tools/ai-registry/validate-catalog-governance.js`46- `tools/ai-registry/validate-authoring-contracts-acceptance.js`47- `tools/ai-registry/component-docs.json`48- `dist/praxis-component-registry-ingestion.json` when present or generated for the task49- `dist/ai-registry-catalog-validation-report.json` and `.md` when catalog governance is validated50- `dist/authoring-contracts-acceptance-gate-report.json` and `.md` when authoring acceptance is validated51- `examples/ai-recipes/praxis-dynamic-fields/*.json` when recipe projection changes52- generated AI registry artifacts when the task requires registry ingestion proof5354The family manifest should capture shared `FieldMetadata`, registry, and editorial semantics. Component profiles should express per-control differences such as text, numeric, option, temporal, upload, display, and entity-lookup behavior.5556The playable catalog is the canonical host/canvas projection for discovery and preview. Hosts, landing pages, playgrounds, and canvas surfaces should derive menus, cards, preview recipes, icons, snippets, and doc links from the exported catalog instead of maintaining manual lists. Markdown docs explain the contract; they must not be parsed as the runtime source of truth.5758`CANVAS_STATE_SERVICE` is intentionally a projection boundary. It stores hovered/selected59`CanvasElementData`, the DOM element, canonical `FieldMetadata`, and a field path. It must not own60control semantics, aliases, option-source contracts, runtime registration, or profile behavior.6162## Required Reasoning6364For each AI/canvas change, answer:6566- What canonical semantic decision is being authored?67- Which runtime/editorial source proves the field exists?68- Which profile or capability tells AI how to choose, configure, or avoid the field?69- Which materialization is derived: catalog, recipe, component docs, metadata editor, canvas state, or runtime preview?70- What would fail if the AI only emitted JSON without grounding in the registry/catalog?71- Which evidence is only a projection? A selected canvas element, playable catalog card, generated ingestion chunk, or preview recipe can point to canonical metadata, but none of them independently author control semantics, option-source contracts, selector aliases, or runtime registration.72- Which evidence statuses are complete, partial, or intentionally skipped: runtime registry, metadata registry, profile/capability, playable catalog, canvas state, registry ingestion, docs, and downstream consumers?73- If the authored decision is `controlType.alias.add`, which canonical alias owner changes?74 `PRAXIS_DYNAMIC_FIELDS_AUTHORING_MANIFEST` exposes the operation so AI can reason about the75 decision, but the implementation path must prove `@praxisui/core` alias normalization first76 (`resolveControlTypeAlias(...)` / `normalizeControlTypeToken(...)`) before treating77 `ComponentRegistryService` fallback synonyms, generated registry chunks, or canvas state as78 evidence. A runtime-only alias is partial AI/canvas coverage.7980Do not use keyword routing as the primary way to pick a field. AI authoring should ground the user intent into canonical control types, option-source contracts, component profiles, and declared tools/catalogs.8182## Coverage Rules8384- Do not duplicate a full manifest per runtime control when a family manifest plus component-level profile is enough.85- Do not claim AI coverage for a package-owned field unless the registry extractor can see either literal `ComponentDocMeta` or a supported editorial factory such as `createWave1ComponentDocMeta(descriptor)`.86- Keep runtime coverage, editorial discovery, AI profile coverage, canvas/playground coverage, generated registry coverage, and docs coverage as separate statuses.87- Registry extraction must prove component docs shape, unique component ids/selectors, expected source metadata, generated ingestion schema, capability chunks, and authoring manifest chunks. Do not treat generated JSON as trusted unless the governance validators pass.88- Authoring acceptance must keep `praxis-dynamic-fields` as a family component with the expected manifest terms, minimum operations/editable targets/validators/examples/control profiles, report sections, and semantic validation evidence.89- Validate option-source and entity lookup controls with `praxis-fields-option-sources`; AI should understand by-ids reload, dependencies, and partial backend waivers instead of authoring a local select workaround.90- Validate AI profile claims with `praxis-fields-control-profile-ai`; canvas/registry evidence is incomplete when runtime coverage depends on fallback normalization, when select/entity examples omit governed by-ids/reload evidence, or when inline explicit overlays omit draft/apply/cancel semantics.91- Keep canvas integration as a projection of field metadata/editorial state. Do not create a second concept layer for canvas-only field behavior when the canonical registry already knows it.92- Canvas state may store selection, hover, focus, draft validation, preview state, DOM reference, and field path, but it must not become the canonical owner of control semantics, metadata shape, aliases, option-source rules, or runtime registration.93- A playable catalog entry is incomplete if its `controlType` is not resolvable by the default `ComponentRegistryService`, unless it is explicitly marked as experimental or host-owned.94- A playable catalog entry is discovery evidence only after it aligns with runtime registration, editorial descriptor/component metadata, profile/capability coverage, and preview recipe. Catalog parity tests are necessary but do not replace option-source, loader, or profile-family validation.95- A preview recipe is incomplete if it demonstrates a control with metadata paths or value shapes not supported by the profile, capability, runtime component, or metadata editor contract. For remote lookup and inline controls, also prove selected-value hydration/by-ids or explicit Apply/Cancel/Clear semantics when those are part of the canonical behavior.96- Alias authoring is incomplete if the manifest operation, generated ingestion chunk, or canvas affordance97 can name an alias that only `ComponentRegistryService` resolves. The AI/canvas proof must include98 core alias normalization and downstream discoverability so generated authoring does not produce a99 control identity that renders in preview but fails metadata-editor, catalog, docs, or registry100 governance.101- Docs and inventories should reference the exported catalog and registry chain. If a host needs custom fields, it may register its own runtime and metadata entries, but it must not override the platform catalog to redefine package-owned semantics.102- For wrapper controls, AI/canvas may choose and place the field through dynamic-fields, but package-specific policy must come from the owning package AI/runtime skill.103104## Inventory Before New Contract105106- `ja-suportado-so-ux`: registry/profile/catalog evidence exists, but canvas, playground, assistant UI, or docs do not expose it clearly.107- `ja-suportado-mal-nomeado-ou-mal-materializado`: the canvas or docs use labels, aliases, or manual seeds while the exported catalog already has canonical `controlType`, interaction pattern, icon, snippet, and doc link.108- `suportado-parcialmente`: some projections exist, but runtime registry, metadata registry, AI profile, capability family, playable catalog, registry ingestion, or docs are not all in sync.109- `lacuna-real-de-contrato`: no canonical manifest target, profile operation, runtime/editorial registration, catalog entry, or registry ingestion path can represent the field decision.110111Only `lacuna-real-de-contrato` justifies new contract work. Otherwise, repair the missing projection and validation gate in the existing chain.112113## Validation114115Prefer focused checks:116117- `npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/ai/praxis-dynamic-fields-authoring-manifest.spec.ts --include=projects/praxis-dynamic-fields/src/lib/ai/control-type-ai-catalog.spec.ts --include=projects/praxis-dynamic-fields/src/lib/ai/inline-filter-recipes.spec.ts` when manifest, control catalog, capability profile, or inline recipes change.118- `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` when playable catalog, preview recipe, discovery materialization, snippets, icons, doc links, or registry parity change.119- `npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/editorial/metadata-contract.spec.ts --include=projects/praxis-dynamic-fields/src/lib/editorial/metadata-i18n-contract.spec.ts` when metadata/editorial coverage or docs-facing metadata changes.120- `npx ng test praxis-dynamic-fields --watch=false --progress=false --include=projects/praxis-dynamic-fields/src/lib/services/component-registry/component-registry.service.spec.ts --include=projects/praxis-dynamic-fields/src/lib/directives/dynamic-field-loader.directive.spec.ts` when runtime registration, loader, or preview resolution changes.121- Add the focused dynamic-field loader specs for metadata refresh, presentation mode, select rebind, skip snapshot, or global states when the canvas/preview workflow depends on those paths.122- `npm run generate:registry:ingestion` when generated component docs, AI metadata, catalog governance, authoring contracts, or registry ingestion can change.123- `node tools/ai-registry/validate-catalog-governance.js` when component docs or ingestion artifacts are generated or consumed as evidence.124- `node tools/ai-registry/validate-authoring-contracts-acceptance.js` when authoring manifest acceptance, semantic reports, or registry ingestion acceptance is in scope.125- `npm run validate:published-doc-assets` when public docs or generated docs assets reflect the changed AI/canvas surface.126- `npm run build:praxis-dynamic-fields` when public exports, catalog exports, profile constants, registry metadata, or runtime registration change.127128For canvas-facing work, also verify that the field can be discovered, selected, configured, previewed, and projected into dynamic-form/metadata-editor consumers through the canonical runtime/editorial chain. A static manifest entry without runtime/editorial proof is not enough.