Praxis Authoring Editors
Use this skill when a task creates, expands, or corrects any configuration that is editable through visual authoring in the Praxis Angular workspace.
This covers the normal authoring path used by libs such as @praxisui/dynamic-form, @praxisui/table, @praxisui/list, @praxisui/charts, @praxisui/page-builder, @praxisui/manual-form, @praxisui/tabs, @praxisui/stepper, @praxisui/metadata-editor, and any editor integrated with @praxisui/settings-panel.
For focused Settings Panel work, use the specialized family: praxis-settings-panel-shell for shell/protocol, praxis-settings-roundtrip-authoring for apply/save/reset/reopen across hosted editors, praxis-settings-global-config for the Global Config Editor, and praxis-settings-ai-i18n-validation for AI manifest and i18n coverage.
For AI-assisted authoring work, use praxis-ai-assistant-runtime, praxis-ai-shell-session-context, praxis-ai-composer-attachments-quick-replies, praxis-ai-turn-orchestration-transport, praxis-ai-backend-config-contracts, praxis-ai-authoring-manifests, praxis-ai-registry-ingestion, and praxis-ai-semantic-intent according to whether the task touches assistant UX/context, composer controls, turn streams, backend contracts, executable manifests, generated registry/catalog artifacts, or semantic intent boundaries.
For shared core-backed editor concerns, use praxis-core-global-actions-metadata for structured global actions and metadata services, praxis-core-widget-observations for dynamic widget/editor observation contracts, praxis-core-i18n-resource-copy for shared i18n copy, and praxis-core-providers-bootstrap for provider or registry wiring.
For Page Builder work, use praxis-page-builder-composition for page/runtime composition, praxis-page-builder-authoring for page config, shell, Settings Panel and child editor hosting, and praxis-page-builder-ai-agentic for agentic page authoring. For Visual Builder rule authoring, use praxis-visual-builder-rules as the umbrella, then narrow to praxis-visual-builder-graph-runtime, praxis-visual-builder-jsonlogic-roundtrip, praxis-visual-builder-schemas-templates, or praxis-visual-builder-ai-validation according to the edited subdomain.
For @praxisui/list, use praxis-list-authoring-settings for list config editor, widget editor, JSON editor, ListAuthoringDocument, Settings Panel round-trip, and runtime/editor parity. Use praxis-list-ai-validation if the same path is authorable by assistant.
For @praxisui/metadata-editor, use praxis-metadata-editor-renderer-coverage for visual renderer/property coverage, praxis-metadata-editor-cascade-normalization for cascades, option-source dependencies, schema normalization, and form factory rules, praxis-metadata-editor-consumer-bridges for dynamic-form/table/manual-form/Page Builder hosts, and praxis-metadata-editor-ai-validation for manifest/capability/context-pack work.
For @praxisui/manual-form, use praxis-manual-form-runtime-bridge as the runtime umbrella and then narrow to praxis-manual-form-field-detection-instance, praxis-manual-form-autosave-persistence, or praxis-manual-form-toolbar-metadata-bridge for detection, draft storage, or metadata bridge work. Use praxis-manual-form-ai-authoring as the authoring umbrella and praxis-manual-form-rules-agentic for config editor, Settings Panel, manifest, capabilities, formRules, JSON Logic, agentic turn flow, and registry work. For @praxisui/editorial-forms, use praxis-editorial-forms-runtime as the runtime umbrella and then narrow to praxis-editorial-forms-journey-snapshot-runtime, praxis-editorial-forms-presentation-diagnostics, or praxis-editorial-forms-data-collection-adapters for journey/snapshot, fallback/presentation, or adapter work. Use praxis-editorial-forms-adapters-ai as the adapters/AI umbrella and praxis-editorial-forms-agentic-authoring for manifest operations, component metadata, registry ingestion, docs, and labs.
For @praxisui/crud, use praxis-crud-runtime-openmodes for runtime/open-mode/launcher behavior, praxis-crud-drawer-adapter-contract for drawer adapter entrypoint and host drawer parity, praxis-crud-dialog-form-host-lifecycle for modal/drawer dynamic-form lifecycle and refresh, and praxis-crud-ai-authoring for CRUD authoring manifest, config editor, and child-operation delegation. For @praxisui/dialog, use praxis-dialog-overlay-runtime for overlay/focus/preset behavior, praxis-dialog-global-actions-ai for global actions, registries, and manifest work, and praxis-dialog-surface-global-actions for surface materialization and drawer bridge behavior.
For @praxisui/tabs, use praxis-tabs-runtime-authoring for group/nav config, quick setup, tabsId, renderBody, selected index, widget events, and tabs editor capability. For @praxisui/stepper, use praxis-stepper-wizard-runtime for stepper config editor, dynamic-form steps, validation, wizard adapter, and stepperId persistence. For @praxisui/expansion, use praxis-expansion-runtime-panels for panel metadata, defaults providers, panel events, widget config editor, and expansionId persistence. Use praxis-navigation-containers-ai-validation when those editor changes are also AI-authorable or registry-projected.
For navigation container nested composition, use praxis-navigation-container-composition-events; for stepper/wizard workflow orchestration, use praxis-stepper-wizard-orchestration; for agentic registry/context-pack behavior, use praxis-navigation-agentic-registry.
For @praxisui/table-rule-builder, use praxis-table-rule-effects-runtime for the effects panel and registry, praxis-table-rule-animation-presets for semantic animations, praxis-table-rule-table-integration for table-owned placement and editor round-trip, and praxis-table-rule-ai-validation when the surface is AI-authorable or registry-projected.
For @praxisui/files-upload, use praxis-files-upload-runtime for runtime/config editor behavior, praxis-files-upload-backend-contract for endpoint/security/quota/rate-limit semantics, praxis-files-upload-form-field for form wrapper integration, and praxis-files-upload-ai-validation when the surface is AI-authorable or registry-projected.
For @praxisui/rich-content, use praxis-rich-content-runtime for RichContentDocument semantics, praxis-rich-content-authoring-settings for config editor and presets, praxis-rich-content-integration-adapters for cross-surface embedding, and praxis-rich-content-ai-security-validation for AI/sanitization/registry work.
For @praxisui/cron-builder, use praxis-cron-builder-runtime for component runtime and preview, praxis-cron-schedule-authoring for canonical schedule semantics and dialects, praxis-cron-builder-form-field for form/metadata integration, and praxis-cron-builder-ai-validation when the surface is AI-authorable or registry-projected.
For @praxisui/charts, use praxis-charts-authoring-settings for config editor and widget editor round-trip, praxis-charts-authoring-catalogs for resource/field/target catalogs and preview mapping, praxis-charts-analytics-interactions for queryContext, stats, drilldown, cross-filter, and selection behavior, praxis-charts-echarts-engine-boundary for preview/runtime ECharts adapter parity, and praxis-charts-ai-handler-contracts when the edited paths are AI-authorable.
For transversal Angular governance around an editor, use praxis-angular-i18n-governance for internal authoring text, praxis-angular-public-api-governance for public editor exports, praxis-angular-docs-playgrounds for examples/docs/playgrounds, praxis-angular-validation-gates to pick the local proof, and praxis-angular-agents-governance when local subarea AGENTS guidance is absent or suspected stale.
Do not use this skill as the primary workflow for @praxisui/dynamic-fields discovery/editorial changes. For that case, use praxis-dynamic-fields-editorial.
For dynamic-fields subdomains, route further to praxis-fields-inline-overlay-runtime,
praxis-fields-text-number-time-controls, praxis-fields-selection-lookup-controls, or
praxis-fields-control-profile-ai before changing metadata-editor coverage, Settings Panel
authoring, or generated docs for those controls.
When the editor is a consumer of @praxisui/dynamic-fields, first determine whether the gap is
runtime/discovery/profile/canvas ownership or only editor materialization:
- runtime/registry/selector gaps belong to
praxis-fields-runtime-loader;
- descriptor/catalog/discovery gaps belong to
praxis-fields-editorial-discovery;
- profile/capability/AI authoring gaps belong to
praxis-fields-control-profile-ai;
- AI/canvas/registry-ingestion evidence gaps belong to
praxis-fields-ai-canvas-validation;
- metadata-editor visual renderer/property coverage belongs to
praxis-metadata-editor-renderer-coverage.
Only change an authoring editor after the owning dynamic-fields layer is correct. Do not add a
consumer-local list, alias map, or JSON fallback to compensate for missing package-owned coverage.
This skill is not a generic frontend-design workflow. For Praxis, the canonical contract and the authoring round-trip matter more than local UI polish. The main question is not "can the user edit it?" but "does the editor express the canonical document correctly, persist it correctly, and survive reopen/reset without drift?"
Before changing this skill or implementing an authoring editor, inspect the current source for the
involved runtime and editor path instead of relying on memory. For widget input editors, this means
the component ComponentDocMeta, configEditor, authoringManifestRef, widget config editor,
editor-capability helpers, focused editor specs, AI manifest/context pack when present, i18n files,
and the host that opens the editor. The goal is to encode working Praxis platform knowledge into the
skill, not only document a UI convention.
Primary Component Map
For Page Builder connection-diagram UX, follow praxis-page-builder-composition
and its references/connection-editor-ux.md, then praxis-page-builder-authoring
when a draft, state description or saved link changes. A connection diagram
does not imply Visual Builder rule-graph ownership. Inspect-only navigation
must be proved free of page mutations; it does not require a save just to
demonstrate opening and closing details.
Use the real component family of the task, not a generic "editor changed" label.
@praxisui/settings-panel: SettingsPanelService, SettingsPanelRef, SettingsValueProvider, global-config-editor, shell Apply / Save / Reset / Cancel
@praxisui/dynamic-form: config-editor, layout-editor, messages-editor, rules-editor, hooks-editor, actions-editor, json-config-editor, canvas editors such as section-editor, row-editor, column-editor
@praxisui/table: praxis-table-config-editor, columns-config-editor, behavior-config-editor, toolbar-actions-editor, table-rules-editor, json-config-editor, CRUD and filter authoring
@praxisui/list: list-config-editor, json-config-editor
@praxisui/page-builder: page-config-editor, dynamic-page-config-editor, widget-shell-editor, connection-editor
@praxisui/metadata-editor: field-metadata-editor, dynamic-editor-renderer, cascade manager, coverage and normalization flows
@praxisui/manual-form: manual-form-config-editor, field detection, ManualFormInstance, field toolbar, metadata bridge, autosave, formRules, and AI authoring flows
@praxisui/editorial-forms: editorial runtime, journey snapshots, block provenance, dataCollection adapters, presentation/fallback diagnostics, component metadata, and manifest operations
@praxisui/crud: CRUD metadata editor, widget config editor, launcher/open-mode authoring, and child delegation
@praxisui/dialog: dialog shell, preset authoring, global actions, component/template registries, and child host authoring
@praxisui/charts: praxis-chart-config-editor, praxis-chart-widget-config-editor, resource/field/target catalogs, preview mapper, queryContext, drilldown, cross-filter, runtime/editor parity, and AI authoring manifest
@praxisui/tabs: tabs config editor, quick setup, editor capability, group/nav document, and AI authoring manifest
@praxisui/stepper: stepper config editor, dynamic-form step config, wizard config adapter, and AI authoring manifest
@praxisui/expansion: expansion widget config editor, provider metadata, panel document, and AI authoring manifest
@praxisui/table-rule-builder: rule effects panel, presets, semantic animations, table rule integration, and AI authoring manifest
@praxisui/files-upload: files upload config editor, widget config editor, field wrapper, backend upload policy, and AI authoring manifest
@praxisui/rich-content: rich-content config editor, guided blocks, preview, JSON diagnostics, presets, validator, and AI authoring manifest
@praxisui/cron-builder: CRON builder runtime metadata, schedule authoring config, preview/diagnostics, form field projection, and AI authoring manifest
@praxisui/visual-builder: visual rule graph, JSON Logic round-trip, schemas/context/templates, property effects, collection validators, and AI authoring manifest
If the problem is structural and spans several editors, bias toward the canonical lib contract instead of patching a consumer editor locally.
For @praxisui/metadata-editor as a dynamic-fields consumer, audit these concrete surfaces before
patching local editor code:
components/field-metadata-editor/field-metadata-editor.component.ts
components/dynamic-editor-renderer/dynamic-editor-renderer.component.ts
config/inline-filter-control-properties.map.ts
config/inline-editor-coverage.spec.ts
- the affected
config/*.config.ts file
services/schema-normalizer.service.ts
services/dynamic-form-factory.service.ts
registry/config-registry.service.ts
- related metadata-editor AI manifest/context-pack files when the change is AI-authorable
The editor may keep advanced JSON fields for genuinely structured or legacy escape-hatch values,
but JSON-only coverage is not enough when the platform already exposes canonical property editors,
catalog entries, AI profiles, or metadata-editor config arrays for that control family.
Canonical Goal
Every authoring change must keep this chain coherent:
canonical config semantics -> editor UI/state -> apply/save payload -> persistence -> reopen/reload -> runtime interpretation
If that chain is unclear, stop treating the task as a local editor tweak and identify the platform owner first.
For assistant-driven or agentic authoring, the same rule applies to progressive turns:
backend/tool event stream -> assistant turn state -> editor UI feedback -> terminal preview/apply payload -> persistence -> reopen/reload
Do not validate only the final response when the editor supports streaming, quick replies, clarifications, attachments, or diagnostics. A correct implementation must apply intermediate turn states to the visible assistant UI before the terminal preview/result, otherwise enterprise users see a stalled or generic assistant even though the backend is producing richer reasoning and context.
For component-scoped assistant authoring, preserve the canonical intent boundary:
consult/answer is for factual questions about the active component context.
edit/componentEditPlan is for governed edits that can become a reviewed patch.
- The frontend should expose safe
authoringContract / consultativeContext facts and send them to the backend orchestrator; it must not classify prompts through local keywords.
- Specialized authoring flows should apply the shared scope policy helpers before backend turn resolution so greetings, loose prompts, or requests outside the active component scope return informational guidance instead of a fabricated patch.
For @praxisui/dynamic-form field metadata, local/transient submit semantics are part of that chain:
source: 'local', transient: true, and submitPolicy are canonical FieldMetadata properties owned by @praxisui/core and consumed by @praxisui/dynamic-form.
- Visual authoring must expose these properties through
@praxisui/metadata-editor or the owning form editor when field metadata is editable.
- JSON-only support is incomplete for this contract because enterprise forms commonly need host-only helper fields that survive apply/save/reopen but stay out of backend payloads.
- Round-trip validation should prove both editor preservation and runtime submit behavior: local/transient fields remain in the UI value model while
formSubmit.formData/HTTP payload omits them by default, with rawFormData retaining the full value bag.
- If a local field later collides with a backend schema field, the local submit semantics must not shadow the server-backed field.
Canonical Boundaries
@praxisui/settings-panel owns the canonical shell for runtime authoring UX.
SettingsPanelBridge, SettingsValueProvider, and Apply / Save / Reset / Cancel are part of the contract.
SettingsPanelService is the authoring drawer. Runtime surface.open drawers belong to the
surface drawer bridge, such as providePraxisSurfaceDrawerBridge(). Do not move runtime drawer
behavior into an authoring editor, and do not display authoring chrome in runtime surfaces unless a
governed runtime contract explicitly declares that behavior.
SettingsPanelConfig.diagnostics and component diagnostics are observability/protocol status, not
persistence or action-gating semantics. Apply/Save gates come from the hosted
SettingsValueProvider state (isDirty$, isValid$, isBusy$) and the owning editor document,
not from shell visibility flags or host-local diagnostics.
- Treat
applied$ as preview and saved$ as final persistence. Hosts must subscribe to and persist
the canonical output shape from the owning editor; subscribing only to one stream, wrapping the
value in a host-local envelope, or persisting diagnostics/runtime context as config is an incomplete
authoring integration.
- Consumer libs own the semantics of the config document they edit.
- Component input editors for dynamic widgets must be published by the owning lib through
ComponentDocMeta.configEditor. Hosts such as @praxisui/page-builder should discover and open that editor via metadata instead of creating local editors for another lib's semantics.
- Widget config editors opened by a host should emit the owning component's canonical input patch or
authoring document shape. When the component metadata exposes
inputPatch, configPatchChange,
savedPatch, or similar host-facing outputs, preserve that shape through
SettingsValueProvider.getSettingsValue()/onSave() instead of inventing a host-local wrapper.
- A visual editor can preserve a config path without proving active runtime support. When a path is
schema-only, declared-only, partially implemented, or preserved mainly for round-trip/backward
compatibility, keep that status explicit in the editor, manifest validators, docs, and tests. Do not
promote it to an enabled primary control or AI-authorable promise until the owning runtime proves the
behavior.
- If the component has
ComponentDocMeta.authoringManifestRef, keep the visual editor, manifest
operations, component capabilities, and config editor specs aligned. The visual editor is not a
substitute for the manifest, and the manifest is not proof that the visual round-trip works.
@praxisui/metadata-editor owns structural metadata authoring concerns such as dynamic renderer coverage, schema normalization, contextual hints, and cascade flows.
@praxisui/metadata-editor is a consumer of dynamic-fields control semantics, not the source of truth
for package-owned FieldControlType, selector mappings, runtime registration, editorial descriptors,
catalog entries, or AI profiles. Its local config/*.config.ts arrays should materialize canonical
properties and preserve round-trip, while the owning dynamic-fields/core layer owns the semantic
identity.
- Inline filter editor coverage must stay aligned with
INLINE_FILTER_CONTROL_TYPE_VALUES and
INLINE_FILTER_EDITOR_PROPERTIES_BY_CONTROL_TYPE. Unknown inline aliases should not cause the editor
to invent a config; they should resolve through the canonical inline map or remain unsupported until
the owning dynamic-fields/core layer is fixed.
- For option-source cascades, treat
x-ui.optionSource.dependsOn and x-ui.optionSource.dependencyFilterMap as the canonical backend/editor shape, and dependencyFields/dependencyFilterMap as runtime/manual metadata. Do not silently migrate persistence between those shapes unless the task explicitly includes an authoring migration; a form cascade editor may hydrate from the canonical shape while preserving its existing save contract.
- For global app actions in authored configs, the canonical persisted shape is
globalAction: { actionId, payload?, payloadExpr?, meta? } and execution goes through GlobalActionService.executeRef(...). Keep action for local component/host events only. Do not persist or reintroduce command strings such as showAlert:..., openUrl:..., navigate:..., apiCall:..., or surface.open:{...}.
- When visual authoring edits a
globalAction payload, reuse the canonical GlobalActionUiSchema/getGlobalActionUiSchema(...) field model and shared global-action authoring helpers where available. Do not leave required payloads as JSON-only fields when the platform already exposes structured fields such as dialog.alert.message; the editor may keep an advanced JSON escape hatch, but the primary path must produce the canonical GlobalActionRef shape and validate required payloads before apply/save.
- Internal authoring chrome is platform text. Labels, placeholders, helper text, section titles, tab titles, empty states, and fallback messages must follow the lib i18n path instead of hardcoded literals.
- Domain Catalog, governance, and semantic context are grounding inputs for authoring decisions, not
rules to copy into local
FormConfig, table config, or CRUD metadata. Persist lightweight
references/probes only when the owning contract declares that shape, such as
queryContext.meta.domainCatalog; do not materialize shared governance rules into component JSON
as a shortcut.
- Composed editors such as CRUD must delegate child semantics to their owners. Form layout,
FieldMetadata, validation rules, and table columns belong to the dynamic-form, metadata-editor,
or table contracts; the composed editor should bind/delegate rather than redefine those contracts.
- When a public authoring surface changes, also review the canonical lib artifacts that govern it:
README.md, src/public-api.ts, and the subarea docs called out by the local AGENTS.md.
- Structural panel problems should be fixed in
@praxisui/settings-panel, not reimplemented in each consumer editor.
Trigger Conditions
Use this skill when the task changes any of:
- a new visual editor for an existing Praxis config document
- a new editable section/tab/panel for an existing editor
- config shape
- defaults
- normalization
- persistence
- restore or reopen behavior
apply/save/reset
- embedded editor fields
- builder panels
- editor sections or tabs
- JSON editor contracts
- settings-panel inputs
- runtime/editor parity
- metadata editor coverage or renderer behavior
- authoring i18n or internal editor text
- editor-specific docs or public API that must stay aligned with the runtime path
Required Preflight
Before editing, answer these explicitly:
- What is the canonical owner of the semantics being edited?
- Is the task creating a new editor surface or correcting an existing one?
- What exact document shape or config path must the editor produce?
- Where does the round-trip fail or need to be introduced:
- open
- edit
- apply
- save
- reset
- reopen
- runtime consume
- Which governed artifacts must stay in sync?
If the owner is unclear, load references/scope-boundaries.md and references/owner-decision-matrix.md before editing.
Required Workflow
- Identify the canonical owner of the config, metadata, or builder semantics.
- Identify the concrete editor family and component that exposes it.
- Map the chain:
runtime config -> editor state -> apply/save payload -> persistence -> reopen/reload
- Decide whether the fix belongs in:
@praxisui/settings-panel
ComponentDocMeta.configEditor in the lib that owns the widget input contract
- the consumer lib editor
@praxisui/metadata-editor
praxis-dynamic-fields-editorial instead of this skill
- For widget-hosted editors, verify the owning component metadata and host contract:
ComponentDocMeta.configEditor
authoringManifestRef when present
SettingsValueProvider output shape
- host-facing
inputPatch/saved patch outputs
- focused editor-capability specs
- Check whether the change affects:
- field visibility
- field editability
- labels or internal authoring text
- i18n coverage for internal authoring text
- defaults
- normalization
- reset semantics
- partial save behavior
- schema normalization or metadata coverage
- docs or
public-api governed by the canonical lib
- If the task creates or significantly expands an editor, load
references/new-editor-checklist.md.
- Run the smallest reliable round-trip validation for that component family.
When Creating A New Editor
Creating a new editor is a contract task, not only a rendering task.
Start from the canonical config/runtime semantics, then make the editor faithfully expose them. Do not invent local aliases, editor-only semantics, or host-only wrappers just to make the UI easier to implement.
Minimum expectations for a new editor:
- the owning lib and owner boundary are explicit
- the edited document shape is known
- dynamic widget input editors are exposed via the owning component metadata (
ComponentDocMeta.configEditor) when the editor is meant to be discovered by hosts
- the editor writes the canonical shape, not a temporary shape
- the editor participates correctly in
Apply / Save / Reset / Cancel when hosted in settings-panel
- reopening the editor reloads the same value without silent normalization drift
- runtime consumes the saved document without adapter-only hacks
- i18n and governed docs/public API are reviewed when the surface is public
- widget-hosted editors preserve the canonical
inputPatch/authoring document shape expected by
page-builder or the host that opened the editor
If the runtime cannot already consume the intended semantics, fix the canonical runtime contract first instead of building a compensating editor.
Required Checks
Before considering the task complete, verify:
- The changed config is still reachable in the canonical editor.
- The editor still emits the correct shape through
SettingsValueProvider.
- Runtime still consumes the saved or applied document without hidden drift.
- Reopening the editor does not lose, rewrite, or silently normalize the value incorrectly.
- Reset semantics remain correct.
- New or changed internal authoring text still follows the workspace i18n rules instead of hardcoded literals.
- If the change touched a governed authoring surface, the canonical
README, public-api, or subarea docs were reviewed for sync.
- If the task created a new editor surface, the editor owner and canonical document shape are now discoverable in the code and docs of the owning lib.
- For widget-hosted editors, the host receives the same canonical input patch or authoring document
shape on apply/save that the owning component documents and tests.
- If the editor change crosses package, docs, i18n, or validation boundaries, the matching transversal Angular skill was applied or explicitly ruled out.
Agentic Manifest Checks
When the authoring surface is an executable AI manifest, treat the manifest as a backend contract, not only as documentation.
- When changing a public
@praxisui/* component, always check whether the change affects the component AI manifest. This applies even when the task starts as a runtime/editor fix rather than a manifest task.
- Review the manifest when the change touches public inputs, outputs, events, editable config paths, authoring operations, capabilities, actions, accepted schemas/paths, runtime/editor parity, persistence,
apply/save/reset/reopen, ComponentDocMeta, public-api, public README, examples, recipes or playgrounds.
- For components with an existing manifest, verify
projects/<lib>/src/lib/ai/*authoring-manifest.ts, focused manifest specs, AI registry projection when applicable, docs/ai/agentic-authoring/component-authoring-contracts, and derived recipes/examples when public behavior changed.
- If no manifest update is required after a functional component change, state why. Do not edit manifests mechanically when the public authoring surface did not change.
- If a public component still has no AI manifest, note whether the change raises manifest priority or should be recorded in the component-authoring-contract docs.
- When a component participates in agentic authoring, review whether its
authoringContext still declares the correct response modes (consult/answer, edit/componentEditPlan), safe consultative facts, and scope policy application before assuming the manifest alone is sufficient.
- If an editor preserves schema-only or declared-only config, require a manifest validator/warning
such as a declared-only-runtime warning before exposing it through AI authoring. A persisted path,
broad
affectedPaths, or JSON editor coverage is not evidence of active runtime behavior.
- Do not count a parent
affectedPaths entry as proof that every descendant capability is authorable. If a catalog publishes nested paths, focused specs must verify that each published path is covered by an operation whose input schema can actually express and validate that path.
- Keep operation schemas concrete for published enum and structured fields. Broad
type: object payloads are acceptable only when paired with an explicit blocker or a downstream schema reference that backend tools can resolve deterministically.
- For operations that use
compile-domain-patch, require a deterministic handler contract in the manifest. The contract should name read paths, write paths, stable identity keys, handler input schema when applicable, failure modes, and a concise operational description.
- Handler names alone are not enough for backend patch compilation. A focused spec should fail if any
compile-domain-patch effect lacks the handler contract or uses array index as canonical identity.
- For family-level manifests, the registry must expose an aggregate entry addressable by the manifest
componentId, not only copies attached to child components. Governance should fail if backend tools cannot resolve the family manifest by COMPONENT_ID or if the aggregate projection count drifts from the child component entries.
- When a runtime/config catalog marks fields as declared-only, the manifest may keep them authorable for config/editor round-trip, but docs and validators must not imply active runtime behavior.
High-Risk Failure Modes
Treat these as canonical risks:
- editor created before clarifying canonical ownership
- editor writes a local convenience shape instead of the runtime contract
- config supported in JSON but hidden in the editor
- field visible but not persisted
- field persisted but ignored by runtime
- schema-only or declared-only fields shown as normal enabled controls without warning, coercion,
manifest validator, or runtime proof
- assistant stream treated as a terminal-only promise, causing progress, clarification, diagnostics, attachments, or quick replies to be hidden until the final response
Apply works but Save does not
Save works but reopen rewrites the value
Reset clears too much or too little
- internal authoring text fixed functionally but left hardcoded outside the canonical i18n path
- editor renderer coverage diverges from what the metadata editor claims to support
- metadata-editor adds a local
controlType option or config to compensate for missing dynamic-fields
runtime/editorial/profile coverage
- dynamic-fields catalog says a control is publishable but the metadata editor cannot configure its
critical paths or only exposes them as unvalidated JSON
- schema normalization or cascade flow mutates adjacent config silently
- public authoring docs describe a path or field that the editor no longer exposes
- component behavior changes while the AI manifest still advertises stale inputs, paths, operations or capability semantics
- manifest coverage tests accept broad parent paths while operation schemas cannot express the nested capability
compile-domain-patch operations expose only handler names, leaving backend tools unable to compile or reject patches deterministically
- family-level manifests are projected only onto child components, leaving no aggregate registry entry addressable by the manifest
componentId
- local workaround in a consumer instead of fixing the canonical panel/editor contract
- page-builder or another host creates a component-specific input editor instead of consuming
ComponentDocMeta.configEditor from the owner lib
- host-specific glue becomes the de facto contract because the owning lib was not corrected
- global actions are serialized through
action strings instead of persisted as structured globalAction
For editor open/apply/cancel/close flows, preserve keyboard reachability and
restore focus to the invoker after the overlay closes or fails. Localized
accessible names and busy/invalid/saved announcements belong to the editor
owner. Pair functional accessibility changes with
praxis-angular-accessibility-governance.
Validation Guidance
Prefer the smallest relevant validation:
openConfigEditor specs when opening or wiring changed
SettingsValueProvider specs when payload or dirty/valid/busy contract changed
- focused integration specs when round-trip changed
- assistant/agentic specs that prove intermediate emitted turn states update the UI before the terminal preview when streaming is supported
- assistant scope-policy specs when the component declares consultative context or component edit plans, proving off-scope prompts stay informational and in-scope prompts still reach governed edit planning
- metadata-editor coverage or renderer specs when the task touches dynamic editor rendering, hints, flows, or schema normalization
- Playwright authoring flows when UI visibility, drag/drop, or multi-step authoring behavior is material and focused specs are not enough
For Playwright authoring flows, prefer stable component-owned data-testid or semantic test ids for opening editor chrome and critical apply/save/reset controls when the test purpose is functional round-trip behavior. Do not make these E2E flows depend on localized labels or visible copy if the component already exposes a stable selector. Keep accessible names, user-visible labels, and i18n coverage validated in focused component specs; stable selectors are not a substitute for accessibility or localization correctness.
When the authoring entrypoint is exposed through a host toolbar, validate the actual entrypoint in the smallest viewport that the workflow claims to support. If the global toolbar hides customization/edit mode in narrow/mobile, provide and validate an equivalent route-local or component-local authoring entrypoint rather than treating desktop access as sufficient.
For Settings Panel, metadata editor, drawer, side-sheet, and inspector flows, include a narrow viewport check with the editor open whenever visual layout changed or the edited field group uses multi-column, inline, or helper-text rows. A runtime screenshot after save is not enough to catch clipped labels, hidden help text, footer overlap, or unreachable apply/save controls inside the editor shell.
When a Playwright authoring flow validates Save/persistence followed by reopen, prefer reopening in a fresh page/context through the same canonical route and config endpoint instead of reusing the same browser page after a long authoring conversation. Reusing the same page can hide or create failures from residual runtime state, pending assistant UI state, stale selected widgets, or client-side caches. Use the existing project helper for clean reopen when one exists, and keep same-page reload assertions only when the behavior under test is explicitly in-place reload/state retention.
Bias the validation toward the owning lib:
dynamic-form: config/layout/messages/rules/hooks/actions/json editor specs, then e2e only if authoring flow changed materially
- for deep
dynamic-form work, use praxis-form-authoring-settings; add praxis-form-layout-canvas for layout/canvas/visual blocks and praxis-form-ai-rules-validation for AI/rules/diagnostics
table: use praxis-table-authoring-settings; run focused editor specs first, then table authoring e2e when config visibility, Settings Panel round-trip, rules, filters, CRUD integration, or drag/drop behavior changed
list: editor specs first, then doc-page or e2e only if canonical authoring behavior changed
page-builder: focused builder or connection specs first; treat settings bridge changes as cross-lib impact
metadata-editor: coverage, renderer, schema-normalizer, and cascade specs before broader validation
settings-panel: panel/service/provider specs when shell semantics changed
Minimum acceptable flow for editable UI config:
open editor -> change value -> apply/save -> runtime reflects -> reopen editor -> value still correct
If no visual editor is affected, say that explicitly in the final response.
References
Load these only as needed:
references/settings-panel-contract.md
references/authoring-round-trip-checklist.md
references/validation-matrix.md
references/scope-boundaries.md
references/owner-decision-matrix.md
references/new-editor-checklist.md
Appearance Draft Validation
For shell appearance controls, treat omitted/cleared values as inheritance and trim
whitespace before draft emission. Validate each CSS field against the property the
runtime actually renders, and keep invalid state, dirty state, customization count,
preview and Save eligibility consistent. Preserve explicit overrides when switching
presets; expose clearing them as an explicit action. Pair this workflow with
praxis-page-builder-authoring and praxis-ui-product-design for the canonical
fields and real-component visual proof.
Widget Editor Reading Order
Inspect the current WidgetShellEditorComponent.editorTopics() before changing navigation: identity, styles, avatar, bindings, behavior, appearance and actions share one draft, with size exposed when the owner provides it. Reuse topic IDs, selection and responsive navigation rather than restoring an obsolete single-page/disclosure arrangement. Keyboard navigation, topic changes and preview collapse must preserve authored values and validity. Keep preset previews derived from Core definitions, including header and body colors. Selection needs a visible non-color marker as well as aria-pressed. Verify the actual widget separately: a schematic preview does not certify chart/list/table composition or persisted overrides.
For hosted widget topics, inspect Core SettingsValueProvider.getSettingsSections() /
selectSettingsSection(id), `SETTINGS_EDIT
…(truncated)
1---2name: praxis-authoring-editors3description: Use when creating, expanding, or correcting visual authoring editors in `@praxisui/*`, especially `settings-panel`, config editors, builders, `metadata-editor`, apply/save/reset flows, persistence, reopening, or runtime/editor parity.4metadata:5 source: https://skillmd.com/skills/codexrodrigues/praxis-authoring-editors6---78# Praxis Authoring Editors910Use this skill when a task creates, expands, or corrects any configuration that is editable through visual authoring in the Praxis Angular workspace.1112This covers the normal authoring path used by libs such as `@praxisui/dynamic-form`, `@praxisui/table`, `@praxisui/list`, `@praxisui/charts`, `@praxisui/page-builder`, `@praxisui/manual-form`, `@praxisui/tabs`, `@praxisui/stepper`, `@praxisui/metadata-editor`, and any editor integrated with `@praxisui/settings-panel`.1314For focused Settings Panel work, use the specialized family: `praxis-settings-panel-shell` for shell/protocol, `praxis-settings-roundtrip-authoring` for apply/save/reset/reopen across hosted editors, `praxis-settings-global-config` for the Global Config Editor, and `praxis-settings-ai-i18n-validation` for AI manifest and i18n coverage.15For AI-assisted authoring work, use `praxis-ai-assistant-runtime`, `praxis-ai-shell-session-context`, `praxis-ai-composer-attachments-quick-replies`, `praxis-ai-turn-orchestration-transport`, `praxis-ai-backend-config-contracts`, `praxis-ai-authoring-manifests`, `praxis-ai-registry-ingestion`, and `praxis-ai-semantic-intent` according to whether the task touches assistant UX/context, composer controls, turn streams, backend contracts, executable manifests, generated registry/catalog artifacts, or semantic intent boundaries.16For shared core-backed editor concerns, use `praxis-core-global-actions-metadata` for structured global actions and metadata services, `praxis-core-widget-observations` for dynamic widget/editor observation contracts, `praxis-core-i18n-resource-copy` for shared i18n copy, and `praxis-core-providers-bootstrap` for provider or registry wiring.17For Page Builder work, use `praxis-page-builder-composition` for page/runtime composition, `praxis-page-builder-authoring` for page config, shell, Settings Panel and child editor hosting, and `praxis-page-builder-ai-agentic` for agentic page authoring. For Visual Builder rule authoring, use `praxis-visual-builder-rules` as the umbrella, then narrow to `praxis-visual-builder-graph-runtime`, `praxis-visual-builder-jsonlogic-roundtrip`, `praxis-visual-builder-schemas-templates`, or `praxis-visual-builder-ai-validation` according to the edited subdomain.18For `@praxisui/list`, use `praxis-list-authoring-settings` for list config editor, widget editor, JSON editor, `ListAuthoringDocument`, Settings Panel round-trip, and runtime/editor parity. Use `praxis-list-ai-validation` if the same path is authorable by assistant.19For `@praxisui/metadata-editor`, use `praxis-metadata-editor-renderer-coverage` for visual renderer/property coverage, `praxis-metadata-editor-cascade-normalization` for cascades, option-source dependencies, schema normalization, and form factory rules, `praxis-metadata-editor-consumer-bridges` for dynamic-form/table/manual-form/Page Builder hosts, and `praxis-metadata-editor-ai-validation` for manifest/capability/context-pack work.20For `@praxisui/manual-form`, use `praxis-manual-form-runtime-bridge` as the runtime umbrella and then narrow to `praxis-manual-form-field-detection-instance`, `praxis-manual-form-autosave-persistence`, or `praxis-manual-form-toolbar-metadata-bridge` for detection, draft storage, or metadata bridge work. Use `praxis-manual-form-ai-authoring` as the authoring umbrella and `praxis-manual-form-rules-agentic` for config editor, Settings Panel, manifest, capabilities, formRules, JSON Logic, agentic turn flow, and registry work. For `@praxisui/editorial-forms`, use `praxis-editorial-forms-runtime` as the runtime umbrella and then narrow to `praxis-editorial-forms-journey-snapshot-runtime`, `praxis-editorial-forms-presentation-diagnostics`, or `praxis-editorial-forms-data-collection-adapters` for journey/snapshot, fallback/presentation, or adapter work. Use `praxis-editorial-forms-adapters-ai` as the adapters/AI umbrella and `praxis-editorial-forms-agentic-authoring` for manifest operations, component metadata, registry ingestion, docs, and labs.21For `@praxisui/crud`, use `praxis-crud-runtime-openmodes` for runtime/open-mode/launcher behavior, `praxis-crud-drawer-adapter-contract` for drawer adapter entrypoint and host drawer parity, `praxis-crud-dialog-form-host-lifecycle` for modal/drawer dynamic-form lifecycle and refresh, and `praxis-crud-ai-authoring` for CRUD authoring manifest, config editor, and child-operation delegation. For `@praxisui/dialog`, use `praxis-dialog-overlay-runtime` for overlay/focus/preset behavior, `praxis-dialog-global-actions-ai` for global actions, registries, and manifest work, and `praxis-dialog-surface-global-actions` for surface materialization and drawer bridge behavior.22For `@praxisui/tabs`, use `praxis-tabs-runtime-authoring` for group/nav config, quick setup, `tabsId`, `renderBody`, selected index, widget events, and tabs editor capability. For `@praxisui/stepper`, use `praxis-stepper-wizard-runtime` for stepper config editor, dynamic-form steps, validation, wizard adapter, and `stepperId` persistence. For `@praxisui/expansion`, use `praxis-expansion-runtime-panels` for panel metadata, defaults providers, panel events, widget config editor, and `expansionId` persistence. Use `praxis-navigation-containers-ai-validation` when those editor changes are also AI-authorable or registry-projected.23For navigation container nested composition, use `praxis-navigation-container-composition-events`; for stepper/wizard workflow orchestration, use `praxis-stepper-wizard-orchestration`; for agentic registry/context-pack behavior, use `praxis-navigation-agentic-registry`.24For `@praxisui/table-rule-builder`, use `praxis-table-rule-effects-runtime` for the effects panel and registry, `praxis-table-rule-animation-presets` for semantic animations, `praxis-table-rule-table-integration` for table-owned placement and editor round-trip, and `praxis-table-rule-ai-validation` when the surface is AI-authorable or registry-projected.25For `@praxisui/files-upload`, use `praxis-files-upload-runtime` for runtime/config editor behavior, `praxis-files-upload-backend-contract` for endpoint/security/quota/rate-limit semantics, `praxis-files-upload-form-field` for form wrapper integration, and `praxis-files-upload-ai-validation` when the surface is AI-authorable or registry-projected.26For `@praxisui/rich-content`, use `praxis-rich-content-runtime` for `RichContentDocument` semantics, `praxis-rich-content-authoring-settings` for config editor and presets, `praxis-rich-content-integration-adapters` for cross-surface embedding, and `praxis-rich-content-ai-security-validation` for AI/sanitization/registry work.27For `@praxisui/cron-builder`, use `praxis-cron-builder-runtime` for component runtime and preview, `praxis-cron-schedule-authoring` for canonical schedule semantics and dialects, `praxis-cron-builder-form-field` for form/metadata integration, and `praxis-cron-builder-ai-validation` when the surface is AI-authorable or registry-projected.28For `@praxisui/charts`, use `praxis-charts-authoring-settings` for config editor and widget editor round-trip, `praxis-charts-authoring-catalogs` for resource/field/target catalogs and preview mapping, `praxis-charts-analytics-interactions` for `queryContext`, stats, drilldown, cross-filter, and selection behavior, `praxis-charts-echarts-engine-boundary` for preview/runtime ECharts adapter parity, and `praxis-charts-ai-handler-contracts` when the edited paths are AI-authorable.29For transversal Angular governance around an editor, use `praxis-angular-i18n-governance` for internal authoring text, `praxis-angular-public-api-governance` for public editor exports, `praxis-angular-docs-playgrounds` for examples/docs/playgrounds, `praxis-angular-validation-gates` to pick the local proof, and `praxis-angular-agents-governance` when local subarea AGENTS guidance is absent or suspected stale.3031Do not use this skill as the primary workflow for `@praxisui/dynamic-fields` discovery/editorial changes. For that case, use `praxis-dynamic-fields-editorial`.32For dynamic-fields subdomains, route further to `praxis-fields-inline-overlay-runtime`,33`praxis-fields-text-number-time-controls`, `praxis-fields-selection-lookup-controls`, or34`praxis-fields-control-profile-ai` before changing metadata-editor coverage, Settings Panel35authoring, or generated docs for those controls.3637When the editor is a consumer of `@praxisui/dynamic-fields`, first determine whether the gap is38runtime/discovery/profile/canvas ownership or only editor materialization:3940- runtime/registry/selector gaps belong to `praxis-fields-runtime-loader`;41- descriptor/catalog/discovery gaps belong to `praxis-fields-editorial-discovery`;42- profile/capability/AI authoring gaps belong to `praxis-fields-control-profile-ai`;43- AI/canvas/registry-ingestion evidence gaps belong to `praxis-fields-ai-canvas-validation`;44- metadata-editor visual renderer/property coverage belongs to `praxis-metadata-editor-renderer-coverage`.4546Only change an authoring editor after the owning dynamic-fields layer is correct. Do not add a47consumer-local list, alias map, or JSON fallback to compensate for missing package-owned coverage.4849This skill is not a generic frontend-design workflow. For Praxis, the canonical contract and the authoring round-trip matter more than local UI polish. The main question is not "can the user edit it?" but "does the editor express the canonical document correctly, persist it correctly, and survive reopen/reset without drift?"5051Before changing this skill or implementing an authoring editor, inspect the current source for the52involved runtime and editor path instead of relying on memory. For widget input editors, this means53the component `ComponentDocMeta`, `configEditor`, `authoringManifestRef`, widget config editor,54editor-capability helpers, focused editor specs, AI manifest/context pack when present, i18n files,55and the host that opens the editor. The goal is to encode working Praxis platform knowledge into the56skill, not only document a UI convention.5758## Primary Component Map5960For Page Builder connection-diagram UX, follow `praxis-page-builder-composition`61and its `references/connection-editor-ux.md`, then `praxis-page-builder-authoring`62when a draft, state description or saved link changes. A connection diagram63does not imply Visual Builder rule-graph ownership. Inspect-only navigation64must be proved free of page mutations; it does not require a save just to65demonstrate opening and closing details.6667Use the real component family of the task, not a generic "editor changed" label.6869- `@praxisui/settings-panel`: `SettingsPanelService`, `SettingsPanelRef`, `SettingsValueProvider`, `global-config-editor`, shell `Apply` / `Save` / `Reset` / `Cancel`70- `@praxisui/dynamic-form`: `config-editor`, `layout-editor`, `messages-editor`, `rules-editor`, `hooks-editor`, `actions-editor`, `json-config-editor`, canvas editors such as `section-editor`, `row-editor`, `column-editor`71- `@praxisui/table`: `praxis-table-config-editor`, `columns-config-editor`, `behavior-config-editor`, `toolbar-actions-editor`, `table-rules-editor`, `json-config-editor`, CRUD and filter authoring72- `@praxisui/list`: `list-config-editor`, `json-config-editor`73- `@praxisui/page-builder`: `page-config-editor`, `dynamic-page-config-editor`, `widget-shell-editor`, `connection-editor`74- `@praxisui/metadata-editor`: `field-metadata-editor`, `dynamic-editor-renderer`, cascade manager, coverage and normalization flows75- `@praxisui/manual-form`: `manual-form-config-editor`, field detection, `ManualFormInstance`, field toolbar, metadata bridge, autosave, formRules, and AI authoring flows76- `@praxisui/editorial-forms`: editorial runtime, journey snapshots, block provenance, dataCollection adapters, presentation/fallback diagnostics, component metadata, and manifest operations77- `@praxisui/crud`: CRUD metadata editor, widget config editor, launcher/open-mode authoring, and child delegation78- `@praxisui/dialog`: dialog shell, preset authoring, global actions, component/template registries, and child host authoring79- `@praxisui/charts`: `praxis-chart-config-editor`, `praxis-chart-widget-config-editor`, resource/field/target catalogs, preview mapper, `queryContext`, drilldown, cross-filter, runtime/editor parity, and AI authoring manifest80- `@praxisui/tabs`: tabs config editor, quick setup, editor capability, group/nav document, and AI authoring manifest81- `@praxisui/stepper`: stepper config editor, dynamic-form step config, wizard config adapter, and AI authoring manifest82- `@praxisui/expansion`: expansion widget config editor, provider metadata, panel document, and AI authoring manifest83- `@praxisui/table-rule-builder`: rule effects panel, presets, semantic animations, table rule integration, and AI authoring manifest84- `@praxisui/files-upload`: files upload config editor, widget config editor, field wrapper, backend upload policy, and AI authoring manifest85- `@praxisui/rich-content`: rich-content config editor, guided blocks, preview, JSON diagnostics, presets, validator, and AI authoring manifest86- `@praxisui/cron-builder`: CRON builder runtime metadata, schedule authoring config, preview/diagnostics, form field projection, and AI authoring manifest87- `@praxisui/visual-builder`: visual rule graph, JSON Logic round-trip, schemas/context/templates, property effects, collection validators, and AI authoring manifest8889If the problem is structural and spans several editors, bias toward the canonical lib contract instead of patching a consumer editor locally.9091For `@praxisui/metadata-editor` as a dynamic-fields consumer, audit these concrete surfaces before92patching local editor code:9394- `components/field-metadata-editor/field-metadata-editor.component.ts`95- `components/dynamic-editor-renderer/dynamic-editor-renderer.component.ts`96- `config/inline-filter-control-properties.map.ts`97- `config/inline-editor-coverage.spec.ts`98- the affected `config/*.config.ts` file99- `services/schema-normalizer.service.ts`100- `services/dynamic-form-factory.service.ts`101- `registry/config-registry.service.ts`102- related metadata-editor AI manifest/context-pack files when the change is AI-authorable103104The editor may keep advanced JSON fields for genuinely structured or legacy escape-hatch values,105but JSON-only coverage is not enough when the platform already exposes canonical property editors,106catalog entries, AI profiles, or metadata-editor config arrays for that control family.107108## Canonical Goal109110Every authoring change must keep this chain coherent:111112`canonical config semantics -> editor UI/state -> apply/save payload -> persistence -> reopen/reload -> runtime interpretation`113114If that chain is unclear, stop treating the task as a local editor tweak and identify the platform owner first.115116For assistant-driven or agentic authoring, the same rule applies to progressive turns:117118`backend/tool event stream -> assistant turn state -> editor UI feedback -> terminal preview/apply payload -> persistence -> reopen/reload`119120Do not validate only the final response when the editor supports streaming, quick replies, clarifications, attachments, or diagnostics. A correct implementation must apply intermediate turn states to the visible assistant UI before the terminal preview/result, otherwise enterprise users see a stalled or generic assistant even though the backend is producing richer reasoning and context.121122For component-scoped assistant authoring, preserve the canonical intent boundary:123124- `consult/answer` is for factual questions about the active component context.125- `edit/componentEditPlan` is for governed edits that can become a reviewed patch.126- The frontend should expose safe `authoringContract` / `consultativeContext` facts and send them to the backend orchestrator; it must not classify prompts through local keywords.127- Specialized authoring flows should apply the shared scope policy helpers before backend turn resolution so greetings, loose prompts, or requests outside the active component scope return informational guidance instead of a fabricated patch.128129For `@praxisui/dynamic-form` field metadata, local/transient submit semantics are part of that chain:130131- `source: 'local'`, `transient: true`, and `submitPolicy` are canonical `FieldMetadata` properties owned by `@praxisui/core` and consumed by `@praxisui/dynamic-form`.132- Visual authoring must expose these properties through `@praxisui/metadata-editor` or the owning form editor when field metadata is editable.133- JSON-only support is incomplete for this contract because enterprise forms commonly need host-only helper fields that survive apply/save/reopen but stay out of backend payloads.134- Round-trip validation should prove both editor preservation and runtime submit behavior: local/transient fields remain in the UI value model while `formSubmit.formData`/HTTP payload omits them by default, with `rawFormData` retaining the full value bag.135- If a local field later collides with a backend schema field, the local submit semantics must not shadow the server-backed field.136137## Canonical Boundaries138139- `@praxisui/settings-panel` owns the canonical shell for runtime authoring UX.140- `SettingsPanelBridge`, `SettingsValueProvider`, and `Apply` / `Save` / `Reset` / `Cancel` are part of the contract.141- `SettingsPanelService` is the authoring drawer. Runtime `surface.open` drawers belong to the142 surface drawer bridge, such as `providePraxisSurfaceDrawerBridge()`. Do not move runtime drawer143 behavior into an authoring editor, and do not display authoring chrome in runtime surfaces unless a144 governed runtime contract explicitly declares that behavior.145- `SettingsPanelConfig.diagnostics` and component diagnostics are observability/protocol status, not146 persistence or action-gating semantics. `Apply`/`Save` gates come from the hosted147 `SettingsValueProvider` state (`isDirty$`, `isValid$`, `isBusy$`) and the owning editor document,148 not from shell visibility flags or host-local diagnostics.149- Treat `applied$` as preview and `saved$` as final persistence. Hosts must subscribe to and persist150 the canonical output shape from the owning editor; subscribing only to one stream, wrapping the151 value in a host-local envelope, or persisting diagnostics/runtime context as config is an incomplete152 authoring integration.153- Consumer libs own the semantics of the config document they edit.154- Component input editors for dynamic widgets must be published by the owning lib through `ComponentDocMeta.configEditor`. Hosts such as `@praxisui/page-builder` should discover and open that editor via metadata instead of creating local editors for another lib's semantics.155- Widget config editors opened by a host should emit the owning component's canonical input patch or156 authoring document shape. When the component metadata exposes `inputPatch`, `configPatchChange`,157 `savedPatch`, or similar host-facing outputs, preserve that shape through158 `SettingsValueProvider.getSettingsValue()`/`onSave()` instead of inventing a host-local wrapper.159- A visual editor can preserve a config path without proving active runtime support. When a path is160 schema-only, declared-only, partially implemented, or preserved mainly for round-trip/backward161 compatibility, keep that status explicit in the editor, manifest validators, docs, and tests. Do not162 promote it to an enabled primary control or AI-authorable promise until the owning runtime proves the163 behavior.164- If the component has `ComponentDocMeta.authoringManifestRef`, keep the visual editor, manifest165 operations, component capabilities, and config editor specs aligned. The visual editor is not a166 substitute for the manifest, and the manifest is not proof that the visual round-trip works.167- `@praxisui/metadata-editor` owns structural metadata authoring concerns such as dynamic renderer coverage, schema normalization, contextual hints, and cascade flows.168- `@praxisui/metadata-editor` is a consumer of dynamic-fields control semantics, not the source of truth169 for package-owned `FieldControlType`, selector mappings, runtime registration, editorial descriptors,170 catalog entries, or AI profiles. Its local `config/*.config.ts` arrays should materialize canonical171 properties and preserve round-trip, while the owning dynamic-fields/core layer owns the semantic172 identity.173- Inline filter editor coverage must stay aligned with `INLINE_FILTER_CONTROL_TYPE_VALUES` and174 `INLINE_FILTER_EDITOR_PROPERTIES_BY_CONTROL_TYPE`. Unknown inline aliases should not cause the editor175 to invent a config; they should resolve through the canonical inline map or remain unsupported until176 the owning dynamic-fields/core layer is fixed.177- For option-source cascades, treat `x-ui.optionSource.dependsOn` and `x-ui.optionSource.dependencyFilterMap` as the canonical backend/editor shape, and `dependencyFields`/`dependencyFilterMap` as runtime/manual metadata. Do not silently migrate persistence between those shapes unless the task explicitly includes an authoring migration; a form cascade editor may hydrate from the canonical shape while preserving its existing save contract.178- For global app actions in authored configs, the canonical persisted shape is `globalAction: { actionId, payload?, payloadExpr?, meta? }` and execution goes through `GlobalActionService.executeRef(...)`. Keep `action` for local component/host events only. Do not persist or reintroduce command strings such as `showAlert:...`, `openUrl:...`, `navigate:...`, `apiCall:...`, or `surface.open:{...}`.179- When visual authoring edits a `globalAction` payload, reuse the canonical `GlobalActionUiSchema`/`getGlobalActionUiSchema(...)` field model and shared global-action authoring helpers where available. Do not leave required payloads as JSON-only fields when the platform already exposes structured fields such as `dialog.alert.message`; the editor may keep an advanced JSON escape hatch, but the primary path must produce the canonical `GlobalActionRef` shape and validate required payloads before apply/save.180- Internal authoring chrome is platform text. Labels, placeholders, helper text, section titles, tab titles, empty states, and fallback messages must follow the lib i18n path instead of hardcoded literals.181- Domain Catalog, governance, and semantic context are grounding inputs for authoring decisions, not182 rules to copy into local `FormConfig`, table config, or CRUD metadata. Persist lightweight183 references/probes only when the owning contract declares that shape, such as184 `queryContext.meta.domainCatalog`; do not materialize shared governance rules into component JSON185 as a shortcut.186- Composed editors such as CRUD must delegate child semantics to their owners. Form layout,187 `FieldMetadata`, validation rules, and table columns belong to the dynamic-form, metadata-editor,188 or table contracts; the composed editor should bind/delegate rather than redefine those contracts.189- When a public authoring surface changes, also review the canonical lib artifacts that govern it: `README.md`, `src/public-api.ts`, and the subarea docs called out by the local `AGENTS.md`.190- Structural panel problems should be fixed in `@praxisui/settings-panel`, not reimplemented in each consumer editor.191192## Trigger Conditions193194Use this skill when the task changes any of:195196- a new visual editor for an existing Praxis config document197- a new editable section/tab/panel for an existing editor198- config shape199- defaults200- normalization201- persistence202- restore or reopen behavior203- `apply/save/reset`204- embedded editor fields205- builder panels206- editor sections or tabs207- JSON editor contracts208- settings-panel inputs209- runtime/editor parity210- metadata editor coverage or renderer behavior211- authoring i18n or internal editor text212- editor-specific docs or public API that must stay aligned with the runtime path213214## Required Preflight215216Before editing, answer these explicitly:2172181. What is the canonical owner of the semantics being edited?2192. Is the task creating a new editor surface or correcting an existing one?2203. What exact document shape or config path must the editor produce?2214. Where does the round-trip fail or need to be introduced:222 - open223 - edit224 - apply225 - save226 - reset227 - reopen228 - runtime consume2295. Which governed artifacts must stay in sync?230231If the owner is unclear, load `references/scope-boundaries.md` and `references/owner-decision-matrix.md` before editing.232233## Required Workflow2342351. Identify the canonical owner of the config, metadata, or builder semantics.2362. Identify the concrete editor family and component that exposes it.2373. Map the chain:238 `runtime config -> editor state -> apply/save payload -> persistence -> reopen/reload`2394. Decide whether the fix belongs in:240 - `@praxisui/settings-panel`241 - `ComponentDocMeta.configEditor` in the lib that owns the widget input contract242 - the consumer lib editor243 - `@praxisui/metadata-editor`244 - `praxis-dynamic-fields-editorial` instead of this skill2455. For widget-hosted editors, verify the owning component metadata and host contract:246 - `ComponentDocMeta.configEditor`247 - `authoringManifestRef` when present248 - `SettingsValueProvider` output shape249 - host-facing `inputPatch`/saved patch outputs250 - focused editor-capability specs2516. Check whether the change affects:252 - field visibility253 - field editability254 - labels or internal authoring text255 - i18n coverage for internal authoring text256 - defaults257 - normalization258 - reset semantics259 - partial save behavior260 - schema normalization or metadata coverage261 - docs or `public-api` governed by the canonical lib2627. If the task creates or significantly expands an editor, load `references/new-editor-checklist.md`.2638. Run the smallest reliable round-trip validation for that component family.264265## When Creating A New Editor266267Creating a new editor is a contract task, not only a rendering task.268269Start from the canonical config/runtime semantics, then make the editor faithfully expose them. Do not invent local aliases, editor-only semantics, or host-only wrappers just to make the UI easier to implement.270271Minimum expectations for a new editor:272273- the owning lib and owner boundary are explicit274- the edited document shape is known275- dynamic widget input editors are exposed via the owning component metadata (`ComponentDocMeta.configEditor`) when the editor is meant to be discovered by hosts276- the editor writes the canonical shape, not a temporary shape277- the editor participates correctly in `Apply` / `Save` / `Reset` / `Cancel` when hosted in `settings-panel`278- reopening the editor reloads the same value without silent normalization drift279- runtime consumes the saved document without adapter-only hacks280- i18n and governed docs/public API are reviewed when the surface is public281- widget-hosted editors preserve the canonical `inputPatch`/authoring document shape expected by282 page-builder or the host that opened the editor283284If the runtime cannot already consume the intended semantics, fix the canonical runtime contract first instead of building a compensating editor.285286## Required Checks287288Before considering the task complete, verify:289290- The changed config is still reachable in the canonical editor.291- The editor still emits the correct shape through `SettingsValueProvider`.292- Runtime still consumes the saved or applied document without hidden drift.293- Reopening the editor does not lose, rewrite, or silently normalize the value incorrectly.294- Reset semantics remain correct.295- New or changed internal authoring text still follows the workspace i18n rules instead of hardcoded literals.296- If the change touched a governed authoring surface, the canonical `README`, `public-api`, or subarea docs were reviewed for sync.297- If the task created a new editor surface, the editor owner and canonical document shape are now discoverable in the code and docs of the owning lib.298- For widget-hosted editors, the host receives the same canonical input patch or authoring document299 shape on apply/save that the owning component documents and tests.300- If the editor change crosses package, docs, i18n, or validation boundaries, the matching transversal Angular skill was applied or explicitly ruled out.301302## Agentic Manifest Checks303304When the authoring surface is an executable AI manifest, treat the manifest as a backend contract, not only as documentation.305306- When changing a public `@praxisui/*` component, always check whether the change affects the component AI manifest. This applies even when the task starts as a runtime/editor fix rather than a manifest task.307- Review the manifest when the change touches public inputs, outputs, events, editable config paths, authoring operations, capabilities, actions, accepted schemas/paths, runtime/editor parity, persistence, `apply/save/reset/reopen`, `ComponentDocMeta`, `public-api`, public README, examples, recipes or playgrounds.308- For components with an existing manifest, verify `projects/<lib>/src/lib/ai/*authoring-manifest.ts`, focused manifest specs, AI registry projection when applicable, `docs/ai/agentic-authoring/component-authoring-contracts`, and derived recipes/examples when public behavior changed.309- If no manifest update is required after a functional component change, state why. Do not edit manifests mechanically when the public authoring surface did not change.310- If a public component still has no AI manifest, note whether the change raises manifest priority or should be recorded in the component-authoring-contract docs.311- When a component participates in agentic authoring, review whether its `authoringContext` still declares the correct response modes (`consult/answer`, `edit/componentEditPlan`), safe consultative facts, and scope policy application before assuming the manifest alone is sufficient.312- If an editor preserves schema-only or declared-only config, require a manifest validator/warning313 such as a declared-only-runtime warning before exposing it through AI authoring. A persisted path,314 broad `affectedPaths`, or JSON editor coverage is not evidence of active runtime behavior.315- Do not count a parent `affectedPaths` entry as proof that every descendant capability is authorable. If a catalog publishes nested paths, focused specs must verify that each published path is covered by an operation whose input schema can actually express and validate that path.316- Keep operation schemas concrete for published enum and structured fields. Broad `type: object` payloads are acceptable only when paired with an explicit blocker or a downstream schema reference that backend tools can resolve deterministically.317- For operations that use `compile-domain-patch`, require a deterministic handler contract in the manifest. The contract should name read paths, write paths, stable identity keys, handler input schema when applicable, failure modes, and a concise operational description.318- Handler names alone are not enough for backend patch compilation. A focused spec should fail if any `compile-domain-patch` effect lacks the handler contract or uses array index as canonical identity.319- For family-level manifests, the registry must expose an aggregate entry addressable by the manifest `componentId`, not only copies attached to child components. Governance should fail if backend tools cannot resolve the family manifest by `COMPONENT_ID` or if the aggregate projection count drifts from the child component entries.320- When a runtime/config catalog marks fields as declared-only, the manifest may keep them authorable for config/editor round-trip, but docs and validators must not imply active runtime behavior.321322## High-Risk Failure Modes323324Treat these as canonical risks:325326- editor created before clarifying canonical ownership327- editor writes a local convenience shape instead of the runtime contract328- config supported in JSON but hidden in the editor329- field visible but not persisted330- field persisted but ignored by runtime331- schema-only or declared-only fields shown as normal enabled controls without warning, coercion,332 manifest validator, or runtime proof333- assistant stream treated as a terminal-only promise, causing progress, clarification, diagnostics, attachments, or quick replies to be hidden until the final response334- `Apply` works but `Save` does not335- `Save` works but reopen rewrites the value336- `Reset` clears too much or too little337- internal authoring text fixed functionally but left hardcoded outside the canonical i18n path338- editor renderer coverage diverges from what the metadata editor claims to support339- metadata-editor adds a local `controlType` option or config to compensate for missing dynamic-fields340 runtime/editorial/profile coverage341- dynamic-fields catalog says a control is publishable but the metadata editor cannot configure its342 critical paths or only exposes them as unvalidated JSON343- schema normalization or cascade flow mutates adjacent config silently344- public authoring docs describe a path or field that the editor no longer exposes345- component behavior changes while the AI manifest still advertises stale inputs, paths, operations or capability semantics346- manifest coverage tests accept broad parent paths while operation schemas cannot express the nested capability347- `compile-domain-patch` operations expose only handler names, leaving backend tools unable to compile or reject patches deterministically348- family-level manifests are projected only onto child components, leaving no aggregate registry entry addressable by the manifest `componentId`349- local workaround in a consumer instead of fixing the canonical panel/editor contract350- page-builder or another host creates a component-specific input editor instead of consuming `ComponentDocMeta.configEditor` from the owner lib351- host-specific glue becomes the de facto contract because the owning lib was not corrected352- global actions are serialized through `action` strings instead of persisted as structured `globalAction`353354For editor open/apply/cancel/close flows, preserve keyboard reachability and355restore focus to the invoker after the overlay closes or fails. Localized356accessible names and busy/invalid/saved announcements belong to the editor357owner. Pair functional accessibility changes with358`praxis-angular-accessibility-governance`.359360## Validation Guidance361362Prefer the smallest relevant validation:363364- `openConfigEditor` specs when opening or wiring changed365- `SettingsValueProvider` specs when payload or dirty/valid/busy contract changed366- focused integration specs when round-trip changed367- assistant/agentic specs that prove intermediate emitted turn states update the UI before the terminal preview when streaming is supported368- assistant scope-policy specs when the component declares consultative context or component edit plans, proving off-scope prompts stay informational and in-scope prompts still reach governed edit planning369- metadata-editor coverage or renderer specs when the task touches dynamic editor rendering, hints, flows, or schema normalization370- Playwright authoring flows when UI visibility, drag/drop, or multi-step authoring behavior is material and focused specs are not enough371372For Playwright authoring flows, prefer stable component-owned `data-testid` or semantic test ids for opening editor chrome and critical apply/save/reset controls when the test purpose is functional round-trip behavior. Do not make these E2E flows depend on localized labels or visible copy if the component already exposes a stable selector. Keep accessible names, user-visible labels, and i18n coverage validated in focused component specs; stable selectors are not a substitute for accessibility or localization correctness.373374When the authoring entrypoint is exposed through a host toolbar, validate the actual entrypoint in the smallest viewport that the workflow claims to support. If the global toolbar hides customization/edit mode in narrow/mobile, provide and validate an equivalent route-local or component-local authoring entrypoint rather than treating desktop access as sufficient.375376For Settings Panel, metadata editor, drawer, side-sheet, and inspector flows, include a narrow viewport check with the editor open whenever visual layout changed or the edited field group uses multi-column, inline, or helper-text rows. A runtime screenshot after save is not enough to catch clipped labels, hidden help text, footer overlap, or unreachable apply/save controls inside the editor shell.377378When a Playwright authoring flow validates `Save`/persistence followed by `reopen`, prefer reopening in a fresh page/context through the same canonical route and config endpoint instead of reusing the same browser page after a long authoring conversation. Reusing the same page can hide or create failures from residual runtime state, pending assistant UI state, stale selected widgets, or client-side caches. Use the existing project helper for clean reopen when one exists, and keep same-page reload assertions only when the behavior under test is explicitly in-place reload/state retention.379380Bias the validation toward the owning lib:381382- `dynamic-form`: config/layout/messages/rules/hooks/actions/json editor specs, then e2e only if authoring flow changed materially383- for deep `dynamic-form` work, use `praxis-form-authoring-settings`; add `praxis-form-layout-canvas` for layout/canvas/visual blocks and `praxis-form-ai-rules-validation` for AI/rules/diagnostics384- `table`: use `praxis-table-authoring-settings`; run focused editor specs first, then table authoring e2e when config visibility, Settings Panel round-trip, rules, filters, CRUD integration, or drag/drop behavior changed385- `list`: editor specs first, then doc-page or e2e only if canonical authoring behavior changed386- `page-builder`: focused builder or connection specs first; treat settings bridge changes as cross-lib impact387- `metadata-editor`: coverage, renderer, schema-normalizer, and cascade specs before broader validation388- `settings-panel`: panel/service/provider specs when shell semantics changed389390Minimum acceptable flow for editable UI config:391392`open editor -> change value -> apply/save -> runtime reflects -> reopen editor -> value still correct`393394If no visual editor is affected, say that explicitly in the final response.395396## References397398Load these only as needed:399400- `references/settings-panel-contract.md`401- `references/authoring-round-trip-checklist.md`402- `references/validation-matrix.md`403- `references/scope-boundaries.md`404- `references/owner-decision-matrix.md`405- `references/new-editor-checklist.md`406407## Appearance Draft Validation408409For shell appearance controls, treat omitted/cleared values as inheritance and trim410whitespace before draft emission. Validate each CSS field against the property the411runtime actually renders, and keep invalid state, dirty state, customization count,412preview and Save eligibility consistent. Preserve explicit overrides when switching413presets; expose clearing them as an explicit action. Pair this workflow with414`praxis-page-builder-authoring` and `praxis-ui-product-design` for the canonical415fields and real-component visual proof.416417## Widget Editor Reading Order418419Inspect the current `WidgetShellEditorComponent.editorTopics()` before changing navigation: identity, styles, avatar, bindings, behavior, appearance and actions share one draft, with size exposed when the owner provides it. Reuse topic IDs, selection and responsive navigation rather than restoring an obsolete single-page/disclosure arrangement. Keyboard navigation, topic changes and preview collapse must preserve authored values and validity. Keep preset previews derived from Core definitions, including header and body colors. Selection needs a visible non-color marker as well as aria-pressed. Verify the actual widget separately: a schematic preview does not certify chart/list/table composition or persisted overrides.420421422For hosted widget topics, inspect Core `SettingsValueProvider.getSettingsSections()` /423`selectSettingsSection(id)`, `SETTINGS_EDIT424425…(truncated)