@wildo-ai/framework-knowledge 1.1.9 → 1.1.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +84 -4
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +39 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +132 -20
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -6
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +85 -8
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +2 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +13 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +10 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +27 -6
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +32 -12
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +149 -11
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +40 -2
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +55 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +10 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +107 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +4 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +2 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +4 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +19 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +19 -1
- package/dist/knowledge/references/brand.name-choice.config.md +20 -3
- package/dist/knowledge/references/brand.name-screening.config.md +58 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +55 -0
- package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
- package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +258 -0
- package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +107 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
- package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
- package/dist/knowledge/references/example.email.template.minimal.md +1 -1
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
- package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
- package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
- package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
- package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
- package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
- package/dist/knowledge/references/experience-plan.config.md +60 -7
- package/dist/knowledge/references/market.context-block.builder.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +43 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
- package/dist/knowledge/references/requirements.references.conventions.md +1 -1
- package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
- package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
- package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
- package/dist/knowledge/references/saas.backend.email.send.md +77 -0
- package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
- package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +124 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
- package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +26 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
- package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
- package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
- package/dist/knowledge/references/website-plan.config.md +26 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
- package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
- package/dist/knowledge/references/zod.factories.code.md +1 -0
- package/dist/knowledge/references/zod.factories.duration.md +1 -0
- package/dist/knowledge/references/zod.factories.money.md +1 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +337 -1
- package/dist/knowledge/registries/playbooks.json +18 -18
- package/dist/knowledge/registries/source-tags.json +1435 -873
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +6 -1
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +2 -1
- package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
- package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
- package/dist/knowledge/skills/config-saas/SKILL.md +25 -11
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -1
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
- package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
- package/dist/knowledge/skills/email-add-template/SKILL.md +27 -5
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +128 -0
- package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -2
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +18 -4
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
- package/dist/knowledge/skills/market-category/SKILL.md +21 -7
- package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +11 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +1 -1
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
- package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +26 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +31 -4
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +30 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
- package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
- package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
- package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +221 -37
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +10 -2
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +16 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +10 -2
- package/dist/knowledge/skills/website-section-hero/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +12 -2
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +15 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
- package/dist/knowledge/topic-index.json +1441 -269
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +4 -4
|
@@ -0,0 +1,316 @@
|
|
|
1
|
+
# saas.frontend.launcher.item-refs
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* What kind of target a launcher item points to.
|
|
14
|
+
*
|
|
15
|
+
* This is a config-time concept — the resolution layer maps each kind to a
|
|
16
|
+
* navigation action. Different from `NavigationContentType` which is a runtime
|
|
17
|
+
* concept for zone content rendering. Both have `RESOURCE_OPERATION` but serve
|
|
18
|
+
* different axes: `LauncherItemTargetKind` = what a launcher item targets,
|
|
19
|
+
* `NavigationContentType` = what renders in a navigation zone.
|
|
20
|
+
*/
|
|
21
|
+
export enum LauncherItemTargetKind {
|
|
22
|
+
/** Navigate to a resource operation (list, create, read, etc.). */
|
|
23
|
+
RESOURCE_OPERATION = 'resource_operation',
|
|
24
|
+
/** Navigate to an application-scoped special view. */
|
|
25
|
+
VIEW = 'view',
|
|
26
|
+
/** Navigate to a resource-scoped special view. */
|
|
27
|
+
RESOURCE_VIEW = 'resource_view',
|
|
28
|
+
/** Navigate to a framework-provided page (home, security settings, etc.). */
|
|
29
|
+
ENGINE_PAGE = 'engine_page',
|
|
30
|
+
/** Render a custom registered React component. */
|
|
31
|
+
CUSTOM_COMPONENT = 'custom_component',
|
|
32
|
+
/** Open the unified Settings Hub (overlay), optionally at a specific section. */
|
|
33
|
+
SETTINGS_SECTION = 'settings_section',
|
|
34
|
+
}
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
38
|
+
|
|
39
|
+
```typescript
|
|
40
|
+
/**
|
|
41
|
+
* What kind of content a sidebar section renders.
|
|
42
|
+
*
|
|
43
|
+
* This is the discriminant for the `SidebarSection` discriminated union.
|
|
44
|
+
* Each content kind has its own set of properties and rendering behavior.
|
|
45
|
+
*/
|
|
46
|
+
export enum SidebarSectionContentKind {
|
|
47
|
+
/** Traditional navigation item list (tree, collapsible, inline create). */
|
|
48
|
+
NAVIGATION_LIST = 'navigation_list',
|
|
49
|
+
/** Filterable resource instance list — fetches from a bound operation. */
|
|
50
|
+
RESOURCE_BROWSER = 'resource_browser',
|
|
51
|
+
/** Guidance/onboarding widget — renders a registered guidance component. */
|
|
52
|
+
GUIDANCE_WIDGET = 'guidance_widget',
|
|
53
|
+
/** Arbitrary registered React component. */
|
|
54
|
+
CUSTOM_COMPONENT = 'custom_component',
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
// ════════════════════════════════════════════════════════════════
|
|
58
|
+
// LauncherItemRef — Discriminated Union
|
|
59
|
+
// ════════════════════════════════════════════════════════════════
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* Points to a resource operation (list, create, read, etc.).
|
|
63
|
+
* The resolution layer resolves this via the resource registry.
|
|
64
|
+
*/
|
|
65
|
+
export interface ResourceOperationItemRef {
|
|
66
|
+
kind: LauncherItemTargetKind.RESOURCE_OPERATION;
|
|
67
|
+
resourceType: string;
|
|
68
|
+
operation: string;
|
|
69
|
+
operationVariant?: string;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** Points to an application-scoped special view. */
|
|
73
|
+
export interface ViewItemRef {
|
|
74
|
+
kind: LauncherItemTargetKind.VIEW;
|
|
75
|
+
viewRef: string;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/** Points to a resource-scoped special view. */
|
|
79
|
+
export interface ResourceViewItemRef {
|
|
80
|
+
kind: LauncherItemTargetKind.RESOURCE_VIEW;
|
|
81
|
+
resourceType: string;
|
|
82
|
+
viewRef: string;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/** Points to a framework page (home, security settings). */
|
|
86
|
+
export interface EnginePageItemRef {
|
|
87
|
+
kind: LauncherItemTargetKind.ENGINE_PAGE;
|
|
88
|
+
pageRef: EnginePageRef;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/** Points to a registered component — engine or application (see `ComponentRegistryRef`). */
|
|
92
|
+
export interface CustomComponentItemRef {
|
|
93
|
+
kind: LauncherItemTargetKind.CUSTOM_COMPONENT;
|
|
94
|
+
/**
|
|
95
|
+
* The name a component is REGISTERED under — an engine `FrontendComponentType` member, or an
|
|
96
|
+
* application component a domain module binds in `componentRegistrations` (#549). Resolved through
|
|
97
|
+
* `ComponentRegistryService` under the default preset; a ref nothing is registered under is
|
|
98
|
+
* reported, never rendered as something plausible.
|
|
99
|
+
*/
|
|
100
|
+
componentRef: string;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/**
|
|
104
|
+
* Opens the unified Settings Hub (overlay), optionally pre-selecting a section.
|
|
105
|
+
* Resolves to a `/settings` / `/settings/:sectionRef` URL navigation — the hub
|
|
106
|
+
* is URL-driven (`useSettingsHubRouterSync` reconstructs it), so every settings
|
|
107
|
+
* entry point converges on one destination.
|
|
108
|
+
*/
|
|
109
|
+
export interface SettingsSectionItemRef {
|
|
110
|
+
kind: LauncherItemTargetKind.SETTINGS_SECTION;
|
|
111
|
+
/** Section to pre-open; omit to open the hub's default section. */
|
|
112
|
+
sectionRef?: string;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* A launcher item reference — identifies WHAT a launcher item targets.
|
|
117
|
+
* Discriminated on `kind`. The resolution layer dispatches on this to
|
|
118
|
+
* produce a `ResolvedNavigationItem`.
|
|
119
|
+
*/
|
|
120
|
+
export type LauncherItemRef =
|
|
121
|
+
| ResourceOperationItemRef
|
|
122
|
+
| ViewItemRef
|
|
123
|
+
| ResourceViewItemRef
|
|
124
|
+
| EnginePageItemRef
|
|
125
|
+
| CustomComponentItemRef
|
|
126
|
+
| SettingsSectionItemRef;
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* Toolbar items are navigation-only launcher refs.
|
|
130
|
+
* Custom-component materialization belongs to other app-level surfaces and is
|
|
131
|
+
* intentionally excluded from the global app-level toolbar contract.
|
|
132
|
+
*/
|
|
133
|
+
export type ToolbarItemRef =
|
|
134
|
+
| ResourceOperationItemRef
|
|
135
|
+
| ViewItemRef
|
|
136
|
+
| ResourceViewItemRef
|
|
137
|
+
| EnginePageItemRef;
|
|
138
|
+
|
|
139
|
+
// ════════════════════════════════════════════════════════════════
|
|
140
|
+
// Per-Launcher Item Types
|
|
141
|
+
// ════════════════════════════════════════════════════════════════
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* A sidebar navigation item — extends `LauncherItemRef` with sidebar-specific
|
|
145
|
+
* display properties. Supports all launcher target kinds as targets.
|
|
146
|
+
*/
|
|
147
|
+
export type SidebarItem = LauncherItemRef & {
|
|
148
|
+
displayPolicy?: SidebarItemDisplayPolicy;
|
|
149
|
+
/**
|
|
150
|
+
* Typed reference to a registered `NotificationBadgeDefinition` — its badge KEY,
|
|
151
|
+
* `<scope>:<identifier>`, built by `buildNotificationBadgeKey` /
|
|
152
|
+
* `notificationBadgeIdentityKey` from `@wildo-ai/saas-models`.
|
|
153
|
+
*
|
|
154
|
+
* The key, not the bare `identifier`: a definition is `(scope, identifier)`, so an identifier
|
|
155
|
+
* alone names a definition only while no second scope declares the same one. Matching on it made
|
|
156
|
+
* the second definition unreachable and gave it the first's count.
|
|
157
|
+
*
|
|
158
|
+
* The resolved definition supplies the display mode / tone / pulse, and the live count comes from
|
|
159
|
+
* `useNotificationBadges`, which indexes by the same key. Reported by `verify-launcher-content`
|
|
160
|
+
* when it resolves to nothing.
|
|
161
|
+
*/
|
|
162
|
+
notificationBadgeRef?: string;
|
|
163
|
+
children?: SidebarItem[];
|
|
164
|
+
runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
|
|
165
|
+
};
|
|
166
|
+
|
|
167
|
+
/** A command menu entry. */
|
|
168
|
+
export type CommandMenuCommand = LauncherItemRef & {
|
|
169
|
+
category?: string;
|
|
170
|
+
shortcut?: string;
|
|
171
|
+
/**
|
|
172
|
+
* OPTIONAL extra literal match terms, appended to the localized keyword set
|
|
173
|
+
* the palette already resolves for this command. These literals are NOT
|
|
174
|
+
* translated — reserve them for genuinely app-specific jargon that no
|
|
175
|
+
* localized label or operation-verb synonym covers (e.g. an internal codename
|
|
176
|
+
* like `"boards"` for a Todo-Lists list command).
|
|
177
|
+
*
|
|
178
|
+
* You do NOT need to author generic action verbs here: for a
|
|
179
|
+
* `RESOURCE_OPERATION` command the framework already folds in the LOCALIZED
|
|
180
|
+
* operation-verb synonyms (`components.APPLICATION_LEVEL_COMMAND_MENU.keywords*`,
|
|
181
|
+
* generated + translated by the labelling pipeline) keyed off the command's
|
|
182
|
+
* core operation semantic, and the record/command noun is covered by the
|
|
183
|
+
* command's already-localized label. So a French user finds "Create Todo" by
|
|
184
|
+
* typing "nouveau"/"créer" without any literal being authored here.
|
|
185
|
+
*/
|
|
186
|
+
searchKeywords?: string[];
|
|
187
|
+
displayPolicy?: CommandMenuDisplayPolicy;
|
|
188
|
+
runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
|
|
189
|
+
};
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
193
|
+
|
|
194
|
+
```typescript
|
|
195
|
+
/**
|
|
196
|
+
* Base properties shared by all sidebar section types.
|
|
197
|
+
* `ref` is `string`-typed — no framework enum, apps define their own refs.
|
|
198
|
+
*/
|
|
199
|
+
export interface SidebarSectionBase {
|
|
200
|
+
contentKind: SidebarSectionContentKind;
|
|
201
|
+
/** Section reference — app-defined, used for i18n and configuration matching. */
|
|
202
|
+
ref: string;
|
|
203
|
+
/** Display label (i18n ref). If omitted, section renders without a header. */
|
|
204
|
+
label?: string;
|
|
205
|
+
/** Icon for the section header. */
|
|
206
|
+
icon?: string;
|
|
207
|
+
/** Whether the section header (label + icon) is rendered. Defaults to `true`. */
|
|
208
|
+
showLabel?: boolean;
|
|
209
|
+
/** Whether the section can be collapsed by the user. */
|
|
210
|
+
collapsible?: boolean;
|
|
211
|
+
/** Whether the section starts collapsed. */
|
|
212
|
+
defaultCollapsed?: boolean;
|
|
213
|
+
/**
|
|
214
|
+
* Mode refs this section is visible in. If omitted, visible in all modes.
|
|
215
|
+
* String-based — validated at startup against `appModes[].ref`.
|
|
216
|
+
* The section is hidden while the active mode is not one of them.
|
|
217
|
+
*/
|
|
218
|
+
visibleInModes?: string[];
|
|
219
|
+
/**
|
|
220
|
+
* Function-based visibility condition for complex scope-dependent logic.
|
|
221
|
+
* Called with the current scope; the section is hidden when it returns false.
|
|
222
|
+
*/
|
|
223
|
+
scopeCondition?: ScopeConditionFn;
|
|
224
|
+
/** Declarative availability evaluated by the app-shell layer: required capabilities and the roles shown to (`visibleToRoles`). */
|
|
225
|
+
runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
/**
|
|
229
|
+
* Traditional navigation item list section.
|
|
230
|
+
* Supports tree hierarchy, inline create, drag-reorder (via behavior).
|
|
231
|
+
*/
|
|
232
|
+
export interface SidebarSection_NavigationList extends SidebarSectionBase {
|
|
233
|
+
contentKind: SidebarSectionContentKind.NAVIGATION_LIST;
|
|
234
|
+
children: SidebarItem[];
|
|
235
|
+
behavior?: SidebarSectionBehavior;
|
|
236
|
+
/**
|
|
237
|
+
* Marks this section as the sidebar's PRIMARY navigation group — the app's
|
|
238
|
+
* top-level destinations (the "Home group"). Primary sections render at the
|
|
239
|
+
* top of the sidebar with no section header and never collapsible. When
|
|
240
|
+
* `SIDEBAR.homeDisplayMode` is `NAVIGATION_ITEM` (the default) the framework's
|
|
241
|
+
* Home row heads that same group, giving the Linear/Notion "Inbox / My Issues
|
|
242
|
+
* right under Home" shape; the other home modes surface home elsewhere and
|
|
243
|
+
* leave this group to the app's own destinations.
|
|
244
|
+
*
|
|
245
|
+
* This is a PLACEMENT/CHROME role, deliberately distinct from
|
|
246
|
+
* `SidebarSectionBehavior` (which describes where a section's ITEMS come
|
|
247
|
+
* from). Section ordering is engine policy and ignores declaration order for
|
|
248
|
+
* the special roles: primary section(s) first, then non-empty
|
|
249
|
+
* `SidebarSectionBehavior.FAVORITES` section(s), then the remaining sections
|
|
250
|
+
* in declared order. Modules can therefore contribute a primary section
|
|
251
|
+
* without the app config having to interleave it manually.
|
|
252
|
+
*/
|
|
253
|
+
isPrimary?: boolean;
|
|
254
|
+
inlineCreate?: SidebarSectionInlineCreate;
|
|
255
|
+
inlineCreateResourceType?: string;
|
|
256
|
+
/** Field that receives the user's input during inline creation. Defaults to `'title'`. */
|
|
257
|
+
inlineCreateField?: string;
|
|
258
|
+
nested?: boolean;
|
|
259
|
+
maxNestingDepth?: number;
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
/**
|
|
263
|
+
* Filterable resource instance list section.
|
|
264
|
+
* Fetches data from a bound operation and displays resource instances.
|
|
265
|
+
*/
|
|
266
|
+
export interface SidebarSection_ResourceBrowser extends SidebarSectionBase {
|
|
267
|
+
contentKind: SidebarSectionContentKind.RESOURCE_BROWSER;
|
|
268
|
+
/** Resource type to browse. */
|
|
269
|
+
resourceType: string;
|
|
270
|
+
/** Override the default LIST operation (optional — defaults to LIST). */
|
|
271
|
+
operation?: string;
|
|
272
|
+
/** Operation variant for filtered views. */
|
|
273
|
+
operationVariant?: string;
|
|
274
|
+
/**
|
|
275
|
+
* Operation used when the user clicks a listed instance.
|
|
276
|
+
* Defaults to READ when available; otherwise falls back to the bound operation.
|
|
277
|
+
*/
|
|
278
|
+
navigateOperation?: string;
|
|
279
|
+
/** Variant for the click/navigation operation. */
|
|
280
|
+
navigateOperationVariant?: string;
|
|
281
|
+
/**
|
|
282
|
+
* Client-side filter predicate applied after fetching.
|
|
283
|
+
* Enables display restrictions (e.g., "starred only").
|
|
284
|
+
*/
|
|
285
|
+
instanceFilter?: (instance: Record<string, unknown>) => boolean;
|
|
286
|
+
/**
|
|
287
|
+
* Custom click handler for resource instances.
|
|
288
|
+
* Default: navigate to instance via `NavigationUtils.resolveResourceUrl()`.
|
|
289
|
+
*/
|
|
290
|
+
onInstanceClick?: (context: ResourceBrowserClickContext) => void;
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
/** Guidance/onboarding widget section. */
|
|
294
|
+
export interface SidebarSection_GuidanceWidget extends SidebarSectionBase {
|
|
295
|
+
contentKind: SidebarSectionContentKind.GUIDANCE_WIDGET;
|
|
296
|
+
/** Reference to a registered guidance component. */
|
|
297
|
+
guidanceRef: string;
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
/** Arbitrary custom component section. */
|
|
301
|
+
export interface SidebarSection_CustomComponent extends SidebarSectionBase {
|
|
302
|
+
contentKind: SidebarSectionContentKind.CUSTOM_COMPONENT;
|
|
303
|
+
/** The name a component is registered under — engine or application (see `ComponentRegistryRef`, #549). */
|
|
304
|
+
componentRef: string;
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
/**
|
|
308
|
+
* Discriminated union of all sidebar section types.
|
|
309
|
+
* Narrow on `contentKind` to access type-specific properties.
|
|
310
|
+
*/
|
|
311
|
+
export type SidebarSection =
|
|
312
|
+
| SidebarSection_NavigationList
|
|
313
|
+
| SidebarSection_ResourceBrowser
|
|
314
|
+
| SidebarSection_GuidanceWidget
|
|
315
|
+
| SidebarSection_CustomComponent;
|
|
316
|
+
```
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
# saas.frontend.launcher.merge-rules
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Merges two `contentSections` arrays.
|
|
14
|
+
*
|
|
15
|
+
* **Merge key:** `ref`
|
|
16
|
+
* **Semantics:** App sections **replace** base sections on collision
|
|
17
|
+
* (full section replace, no item-level deep merge). Base-only sections
|
|
18
|
+
* preserved.
|
|
19
|
+
*
|
|
20
|
+
* @param base - Base sections array (e.g., from a kit preset)
|
|
21
|
+
* @param override - App-specific sections array (wins on collision)
|
|
22
|
+
* @returns Merged sections array
|
|
23
|
+
*/
|
|
24
|
+
export function mergeSidebarSections(
|
|
25
|
+
base: SidebarSection[] | undefined,
|
|
26
|
+
override: SidebarSection[] | undefined,
|
|
27
|
+
): SidebarSection[] {
|
|
28
|
+
if (!base && !override) return [];
|
|
29
|
+
if (!base) return warnOnDuplicateLauncherTargets([...(override ?? [])]);
|
|
30
|
+
if (!override) return warnOnDuplicateLauncherTargets([...(base ?? [])]);
|
|
31
|
+
|
|
32
|
+
return warnOnDuplicateLauncherTargets(mergeByKey(base, override, s => s.ref));
|
|
33
|
+
}
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
37
|
+
|
|
38
|
+
```typescript
|
|
39
|
+
/**
|
|
40
|
+
* Stable key for deduping launcher rows (sidebar children, command list, etc.).
|
|
41
|
+
*
|
|
42
|
+
* Two entries with the same key open the same target, so they are one entry. Every `kind` has its own key, and a
|
|
43
|
+
* settings command keys on its `sectionRef`, so commands opening different settings sections never collapse.
|
|
44
|
+
*
|
|
45
|
+
* Exhaustive over `LauncherItemTargetKind` on purpose. It used to end in a `default` that answered `'unknown'`, and
|
|
46
|
+
* `SETTINGS_SECTION` fell into it: every settings command then shared one key, so an application's `members` command
|
|
47
|
+
* collapsed into the engine's billing command and disappeared. A kind added to the enum is now a compile error here.
|
|
48
|
+
*/
|
|
49
|
+
export function launcherItemRefKey(item: LauncherItemRef): string {
|
|
50
|
+
switch (item.kind) {
|
|
51
|
+
case LauncherItemTargetKind.RESOURCE_OPERATION:
|
|
52
|
+
return `resource_operation:${item.resourceType}:${item.operation}:${item.operationVariant ?? 'default'}`;
|
|
53
|
+
case LauncherItemTargetKind.VIEW:
|
|
54
|
+
return `${item.kind}:${item.viewRef}`;
|
|
55
|
+
case LauncherItemTargetKind.RESOURCE_VIEW:
|
|
56
|
+
return `${item.kind}:${item.resourceType}:${item.viewRef}`;
|
|
57
|
+
case LauncherItemTargetKind.ENGINE_PAGE:
|
|
58
|
+
return `engine_page:${item.pageRef}`;
|
|
59
|
+
case LauncherItemTargetKind.CUSTOM_COMPONENT:
|
|
60
|
+
return `custom_component:${item.componentRef}`;
|
|
61
|
+
case LauncherItemTargetKind.SETTINGS_SECTION:
|
|
62
|
+
// No section opens the hub at its landing; that is one destination, so it is one key.
|
|
63
|
+
return `settings_section:${item.sectionRef ?? ''}`;
|
|
64
|
+
default: {
|
|
65
|
+
const unhandled: never = item;
|
|
66
|
+
throw new Error(`launcherItemRefKey: unhandled launcher item kind ${JSON.stringify(unhandled)}`);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Appends sidebar navigation children to the `NAVIGATION_LIST` section with `sectionRef`.
|
|
73
|
+
* Skips items whose `launcherItemRefKey` already exists under that section (idempotent).
|
|
74
|
+
*/
|
|
75
|
+
export function appendNavChildrenToSidebarSection(
|
|
76
|
+
sections: SidebarSection[] | undefined,
|
|
77
|
+
sectionRef: string,
|
|
78
|
+
items: SidebarItem[],
|
|
79
|
+
): SidebarSection[] {
|
|
80
|
+
if (!sections?.length) return sections ?? [];
|
|
81
|
+
if (!items.length) return [...sections];
|
|
82
|
+
|
|
83
|
+
return sections.map(section => {
|
|
84
|
+
if (section.ref !== sectionRef || section.contentKind !== SidebarSectionContentKind.NAVIGATION_LIST) {
|
|
85
|
+
return section;
|
|
86
|
+
}
|
|
87
|
+
const nav = section as Extract<SidebarSection, { contentKind: SidebarSectionContentKind.NAVIGATION_LIST }>;
|
|
88
|
+
const existing = new Set(nav.children.map(launcherItemRefKey));
|
|
89
|
+
const toAdd = items.filter(i => !existing.has(launcherItemRefKey(i)));
|
|
90
|
+
if (toAdd.length === 0) return section;
|
|
91
|
+
return { ...nav, children: [...nav.children, ...toAdd] };
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* Merges command menu command arrays by `launcherItemRefKey` — override wins on collision.
|
|
97
|
+
*/
|
|
98
|
+
export function mergeCommandMenuCommandLists(
|
|
99
|
+
base: CommandMenuCommand[] | undefined,
|
|
100
|
+
extra: CommandMenuCommand[] | undefined,
|
|
101
|
+
): CommandMenuCommand[] {
|
|
102
|
+
if (!base?.length) return [...(extra ?? [])];
|
|
103
|
+
if (!extra?.length) return [...base];
|
|
104
|
+
return mergeByKey(base, extra, launcherItemRefKey);
|
|
105
|
+
}
|
|
106
|
+
```
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# saas.frontend.launcher.runtime-availability
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* When a launcher entry appears at all: `runtimeAvailability` on a sidebar section, a sidebar item, a command-menu
|
|
14
|
+
* command, a quick action, a toolbar, control-panel or menubar item, or a hotkey. An entry that fails it is removed, not
|
|
15
|
+
* shown disabled.
|
|
16
|
+
*
|
|
17
|
+
* - `requiredCapabilities`: runtime capabilities that must all be on (`billingEnabled`, `ssoEnabled`…).
|
|
18
|
+
* - `visibleToRoles`: the roles the entry is shown to (an office-only section a field technician does not see).
|
|
19
|
+
*
|
|
20
|
+
* Import from `@wildo-ai/saas-frontend-lib`.
|
|
21
|
+
*
|
|
22
|
+
* @example
|
|
23
|
+
* // frontend/src/config/app-shell.config.ts: a sidebar section only office staff see
|
|
24
|
+
* { contentKind: SidebarSectionContentKind.NAVIGATION_LIST, ref: 'office',
|
|
25
|
+
* runtimeAvailability: { visibleToRoles: ['office-manager', CORE_ORG_ROLES.ORG_ADMIN] },
|
|
26
|
+
* children: [{ kind: LauncherItemTargetKind.VIEW, viewRef: 'invoices' }] }
|
|
27
|
+
*
|
|
28
|
+
* This is intentionally distinct from `requiredFeatures` on resolved
|
|
29
|
+
* view/resource targets:
|
|
30
|
+
* - `runtimeAvailability` decides whether a launcher declaration should survive
|
|
31
|
+
* the app-shell filtering pass at all
|
|
32
|
+
* - `requiredFeatures` stays the canonical plan/subscription gating mechanism
|
|
33
|
+
* once an item has already survived launcher filtering and is being resolved
|
|
34
|
+
*/
|
|
35
|
+
export interface LauncherRuntimeAvailabilityConfig {
|
|
36
|
+
requiredCapabilities?: string[];
|
|
37
|
+
/**
|
|
38
|
+
* The roles this item is shown to: an office-only "Invoices" section a field technician does not see. Visible when the
|
|
39
|
+
* viewer holds ANY listed role, at the application or in the current organization, or a CORE role that inherits one
|
|
40
|
+
* (an organization owner sees an `ORG_MEMBER` item).
|
|
41
|
+
*
|
|
42
|
+
* A custom role counts only as itself: the browser receives the application's role keys, not how its custom roles
|
|
43
|
+
* inherit, so list every role that should see the item. Never wider: an unknown role does not reveal an item, because
|
|
44
|
+
* the declaration names exactly who it is for.
|
|
45
|
+
*
|
|
46
|
+
* Navigation, not authorization. Hiding an entry stops nobody from opening its target; the target operation's `roles`
|
|
47
|
+
* are what the backend enforces. An entry opening a resource operation the viewer's roles cannot perform is already
|
|
48
|
+
* hidden by resolution, so `visibleToRoles` is for narrowing further: an operation open to every member that only
|
|
49
|
+
* office staff need in their navigation.
|
|
50
|
+
*
|
|
51
|
+
* Omitted or empty: shown to every role.
|
|
52
|
+
*/
|
|
53
|
+
visibleToRoles?: string[];
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export const LauncherRuntimeAvailabilityConfigSchema = z.object({
|
|
57
|
+
requiredCapabilities: z.array(z.string()).optional(),
|
|
58
|
+
visibleToRoles: z.array(z.string().min(1)).optional(),
|
|
59
|
+
});
|
|
60
|
+
```
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# saas.frontend.resource-label-params
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Parameters passed to a `getFrontendResourceLabel` function: what a resource's ui-behavior receives when it names one
|
|
14
|
+
* record (a list row, a page title, a reference chip). Import the type from `@wildo-ai/saas-frontend-lib`.
|
|
15
|
+
*
|
|
16
|
+
* Words in a label come from `t`, which takes a FULL key (`resources.<type>.…`). This resource's own `resources.<type>`
|
|
17
|
+
* words are always loaded; a label that also needs words from ANOTHER label section declares it in
|
|
18
|
+
* `instanceLabelSections`, or `t` renders the key itself wherever that section has not been loaded. Dates go through
|
|
19
|
+
* `formatDate` / `formatDateTime`, never a hand-formatted string.
|
|
20
|
+
*
|
|
21
|
+
* Generic `TMainSchema` defaults to `z.ZodAny` — presets and records use the
|
|
22
|
+
* default (giving `currentObject: any`), while app-level configs can narrow it
|
|
23
|
+
* to a concrete schema for type-safe field access.
|
|
24
|
+
*
|
|
25
|
+
* @example
|
|
26
|
+
* // An invoice named by its number and its issue date, in the viewer's date format.
|
|
27
|
+
* getFrontendResourceLabel: ({ currentObject, formatDate }) => `${currentObject.number} · ${formatDate(currentObject.issuedAt)}`,
|
|
28
|
+
*/
|
|
29
|
+
export type ResourceUIBehaviorLabelParams<TMainSchema extends z.ZodTypeAny = z.ZodAny> = {
|
|
30
|
+
currentObject: z.infer<TMainSchema>;
|
|
31
|
+
objectContext: any;
|
|
32
|
+
initiatorUserContext?: any;
|
|
33
|
+
t: (toTranslate: string, params?: Record<string, any>) => string;
|
|
34
|
+
/**
|
|
35
|
+
* Formats a date the way the viewer's regional preferences (date format, timezone) render one everywhere
|
|
36
|
+
* else. A label built from a date must use it: a hand-formatted `YYYY-MM-DD` agreed with the record's own
|
|
37
|
+
* card only for a viewer whose preference happened to be ISO, and a different timezone could shift the day.
|
|
38
|
+
*/
|
|
39
|
+
formatDate: (value: Date | string | number) => string;
|
|
40
|
+
/**
|
|
41
|
+
* `formatDate` with the time of day, for a record whose name is an instant rather than a day — an audit
|
|
42
|
+
* event, where many share a date and only the time tells them apart.
|
|
43
|
+
*/
|
|
44
|
+
formatDateTime: (value: Date | string | number) => string;
|
|
45
|
+
/**
|
|
46
|
+
* The resource being named. One polymorphic behavior serves several resource types (an organization's and a
|
|
47
|
+
* user's billing account share one callback), and a record with no name of its own is named by ITS resource's
|
|
48
|
+
* words — which only the resource type can address in the label tree.
|
|
49
|
+
*/
|
|
50
|
+
resourceType: string;
|
|
51
|
+
};
|
|
52
|
+
```
|
|
@@ -53,6 +53,8 @@ export enum CollectionFilterPanelVisibility {
|
|
|
53
53
|
HIDDEN = 'hidden',
|
|
54
54
|
}
|
|
55
55
|
|
|
56
|
+
/**
|
|
57
|
+
*/
|
|
56
58
|
/**
|
|
57
59
|
* A DATE WINDOW named relative to NOW, for a preset filter that must mean the same thing tomorrow.
|
|
58
60
|
*
|
|
@@ -65,39 +67,63 @@ export enum CollectionFilterPanelVisibility {
|
|
|
65
67
|
* Resolution is in the VIEWER's timezone, which is the only one that makes "today" true for the
|
|
66
68
|
* person reading the screen. The backend compares instants, so the boundaries travel as absolute
|
|
67
69
|
* times and nothing downstream has to know a timezone was involved.
|
|
70
|
+
*
|
|
71
|
+
* Every window is whole local days and ends at the LAST instant of its last day, one millisecond before the next local
|
|
72
|
+
* midnight. The date-range filter's end bound is inclusive, and a date-only value (a due date picked in a calendar) is
|
|
73
|
+
* stored at the local midnight of the day it names, so ending at the next midnight would also match the day after.
|
|
68
74
|
*/
|
|
69
75
|
export enum CollectionFilterPresetRelativeRange {
|
|
70
|
-
/**
|
|
76
|
+
/** All of today, local: midnight this morning to the end of the day. */
|
|
71
77
|
TODAY = 'today',
|
|
72
|
-
/**
|
|
78
|
+
/** All of yesterday, local. */
|
|
73
79
|
YESTERDAY = 'yesterday',
|
|
74
80
|
/** The last seven days INCLUDING today — the rolling week, not the last seven whole days. */
|
|
75
81
|
LAST_7_DAYS = 'last_7_days',
|
|
76
82
|
/** The last thirty days including today. */
|
|
77
83
|
LAST_30_DAYS = 'last_30_days',
|
|
78
|
-
/** The first of this calendar month
|
|
84
|
+
/** The first of this calendar month through the end of today. */
|
|
79
85
|
THIS_MONTH = 'this_month',
|
|
80
|
-
/** The first of this calendar year
|
|
86
|
+
/** The first of this calendar year through the end of today. */
|
|
81
87
|
THIS_YEAR = 'this_year',
|
|
88
|
+
/**
|
|
89
|
+
* Everything BEFORE today, local: what an "overdue" list shows on a due-date field. Ends at the last instant of
|
|
90
|
+
* yesterday, so a date-only value due TODAY is due, not overdue. A deadline with a time earlier today is in TODAY, not
|
|
91
|
+
* here: the window is whole days, like every other member, so the pill reads the same all day.
|
|
92
|
+
*/
|
|
93
|
+
BEFORE_TODAY = 'before_today',
|
|
94
|
+
/** Today and the six days after it, local: "due this week" from today. */
|
|
95
|
+
NEXT_7_DAYS = 'next_7_days',
|
|
96
|
+
/** Today and the twenty-nine days after it, local. */
|
|
97
|
+
NEXT_30_DAYS = 'next_30_days',
|
|
82
98
|
}
|
|
83
99
|
|
|
84
100
|
/**
|
|
85
|
-
*
|
|
101
|
+
* A value a preset can only know once it is clicked, because it depends on WHO is looking. Resolved from the
|
|
102
|
+
* viewer's session at that moment, like a relative range is resolved from the clock, so "My jobs" means the person
|
|
103
|
+
* reading the list, whoever that is.
|
|
86
104
|
*
|
|
87
|
-
*
|
|
88
|
-
*
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
*
|
|
97
|
-
* vocabulary — a preset assigning one is writing the same value the filter panel's own two inputs do.
|
|
105
|
+
* A preset naming one is unavailable to a viewer the value cannot be resolved for (no signed-in user): the pill is
|
|
106
|
+
* disabled rather than applied without the field, which would show a different list under the same name.
|
|
107
|
+
*/
|
|
108
|
+
export enum CollectionFilterPresetContextValue {
|
|
109
|
+
/** The signed-in user's id, for a reference field such as an assignee or owner. */
|
|
110
|
+
CURRENT_USER = 'current_user',
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* What a preset ASSIGNS to one filter field.
|
|
98
115
|
*
|
|
99
|
-
*
|
|
100
|
-
*
|
|
116
|
+
* Four kinds, split by WHEN the value is known:
|
|
117
|
+
*
|
|
118
|
+
* - a LITERAL (string, number, boolean) is fixed at authoring time and covers every enum value, id, number and flag,
|
|
119
|
+
* which is the whole of "filter to HIGH priority";
|
|
120
|
+
* - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case, resolved when the pill is clicked, because an authored
|
|
121
|
+
* answer would be wrong by tomorrow;
|
|
122
|
+
* - a NUMERIC BOUND (`{ min?, max? }`) writes the same value the filter panel's own two number inputs do, and the
|
|
123
|
+
* backend applies it on every adapter. Both bounds are optional because "under 500" has no floor, and that is the
|
|
124
|
+
* commonest threshold anyone asks for;
|
|
125
|
+
* - a CONTEXT VALUE (`{ contextValue }`) is known only from who is looking, such as "assigned to me", and is resolved
|
|
126
|
+
* when the pill is clicked, so the same authored preset shows each viewer their own rows.
|
|
101
127
|
*/
|
|
102
128
|
export const CollectionFilterPresetValueSchema = z.union([
|
|
103
129
|
z.string(),
|
|
@@ -105,6 +131,7 @@ export const CollectionFilterPresetValueSchema = z.union([
|
|
|
105
131
|
z.boolean(),
|
|
106
132
|
z.object({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
|
|
107
133
|
z.object({ min: z.number().optional(), max: z.number().optional() }),
|
|
134
|
+
z.object({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
|
|
108
135
|
]);
|
|
109
136
|
export type CollectionFilterPresetValue = z.infer<typeof CollectionFilterPresetValueSchema>;
|
|
110
137
|
|
|
@@ -668,6 +695,8 @@ export const ResourceOperationFrontendConfigSchema = z.object({
|
|
|
668
695
|
* presetFilters: [
|
|
669
696
|
* { ref: 'urgent', filters: { priority: 'high' } },
|
|
670
697
|
* { ref: 'created-today', filters: { createdAt: { relativeRange: CollectionFilterPresetRelativeRange.TODAY } } },
|
|
698
|
+
* { ref: 'overdue', filters: { dueAt: { relativeRange: CollectionFilterPresetRelativeRange.BEFORE_TODAY }, status: 'open' } },
|
|
699
|
+
* { ref: 'mine', filters: { assigneeUserId: { contextValue: CollectionFilterPresetContextValue.CURRENT_USER } } },
|
|
671
700
|
* ]
|
|
672
701
|
*/
|
|
673
702
|
presetFilters: z.array(CollectionFilterPresetSchema).optional(),
|
|
@@ -139,7 +139,10 @@ export type ResourceUIBehaviorConfig<
|
|
|
139
139
|
* Can be either:
|
|
140
140
|
* - `string[]` — array of field paths to concatenate (each entry is a field
|
|
141
141
|
* name on the summary record, including any server-resolved virtual field
|
|
142
|
-
* such as a `forwardedLabel`, e.g. `['instanceLabel']`).
|
|
142
|
+
* such as a `forwardedLabel`, e.g. `['instanceLabel']`). The present,
|
|
143
|
+
* non-empty values are trimmed and joined with ONE SPACE (`['firstName',
|
|
144
|
+
* 'lastName']` → "Ada Lovelace"); for any other separator, or for words,
|
|
145
|
+
* use the function form.
|
|
143
146
|
* - `(params: ResourceUIBehaviorLabelParams) => string` — a function
|
|
144
147
|
*
|
|
145
148
|
* Used by `ResourceListItemRenderer` (rows) and `ResourceLayout_Header` (titles).
|